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ADVANCED MONITOR SOFTWARE SYSTEM 

The ADVANCED Monitor software system described in this manual may be 
obtained in either of two versions: 1) a standard PAGE mode system 
or 2) an optional BANK mode system. 

Page Mode System 

The ADVANCED Monitor Page mode system loads and relocates user programs 
in 4K pages and permits address modification via the index register. 

The Page mode system is supplied as standard software with the 
PDP-15/20/30 and /40 systems. 


NOTE 

With the exception of Appendix G, or where 
otherwise referenced, the information 
presented in this manual concerns only the 
Page mode ADVANCED Monitor software system. 


Bank Mode System 


The optional Bank mode system permits direct addressing within 8K 
banks, but does not permit the use of the index register for address 
modification. This system is useful to the PDP-15 user who prefers 
direct addressing up to 8K, or who wishes to take advantage of the 
extensive library of PDP-9 programs now available from the Digital 
Equipment Computer Users Society (DECUS) . 

The Bank mode system is also available to PDP-9 users who have equip- 
ment configurations comparable to those of the basic PDP-15/20. This 
enables the PDP-9 user to avail himself of the many improvements 
introduced into the PDP-15 ADVANCED Monitor software system. 

The differences between the Page and Bank mode systems and procedures 
for the installation of the Bank mode system are given in Appendix G. 

OPTIONAL KEYBOARD MONITOR 


The ADVANCED Monitor software system contains a sophisticated inter- 
active keyboard/program monitor which is available in either a standard 
or a "special" version. The special version (designated KMS15) permits 
overprinting on the console teleprinter, the standard version does not. 
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Overprinting, a feature useful to FORTRAN programming, requires a 
slightly larger monitor (+24^^ words) . If the user desires the KMS15 
version, it must be installed into the standard system. Appendix G 
contains a brief description of the KMS15 monitor and instructions for 
its installation. 

HOW ADVANCED SOFTWARE SYSTEMS ARE SUPPLIED 


The ADVANCED Monitor software is supplied to the user (Page or Bank 
mode) in the form of two DECtapes ; 

1) a standard system DECtape (Page or Bank mode) which contains 
all programs considered as standard to the system. The 
separate Page and Bank mode system DECtapes are identified 
as follows: 

a) Page Mode DEC-15-SRZB-UC 

b) Bank Mode DEC-15-SWZA-UC 

2) a peripheral DECtape common to both Page and Bank mode 
systems which contains device handlers and routines for 
Digital-offered optional peripherals and special programs 
(e.g., KMS 15). The peripheral DECtape is identified as 
DEC-15-SZZB-UC. 

OVERALL PDP-15 DOCUMENTATION STRUCTURE 


A tree-type block diagram of the overall "PDP-15 Family of Manuals" 
is illustrated on the following page. A brief description of the 
contents and the order number of each manual shown in the diagram are 
also presented. 

ORGANIZATION OF PDP-15 SOFTWARE MANUALS 


There are two basic categories of PDP-15 software manuals: 


a. Unique, single-system manuals which contain information 
concerning only one of the four available PDP-15 systems. 
This category consists of detailed software system 
descriptive manuals, each with an associated operational 
command summary. An example of this class of manual 
would be the "PDP-15/20 Software System" manual and its 
associated "PDP-15/20 User ' s Guide" . 

b. Common, multi-system manuals that describe utility, 
language, application and other PDP-15 programs which 
may be employed in one or more of the four available 
PDP-15 systems. Some examples of this type of manual 
are the PDP-15 "Utility", "MACRO-15 Assembler", and 
"STATPAC" manuals. 
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CHAPTER 1 


ADVANCED SOFTWARE SYSTEM 


1,1 INTRODUCTION 

The ADVANCED Software System is a complete integrated system of programs 
for the preparation, compilation, assembly, debugging, and operation of 
user programs, A diagram illustrating the structure of the ADVANCED 
software system is shown in Figure 1-1. As shown, this software system 
includes: 


a. Compiler and assembly language programs 

b. A large group of prograroming and operational aid (Utility) 
programs 

c. A versatile and flexible Input/Output Programming System (lOPS) 

d. A sophisticated interactive keyboard/program monitor which 
permits device-independent programming and automatic 
creation, calling, and loading of programs. 

Upwards-compatibility exists between all PDP-15 Monitor Systems 
(e.g., programs prepared for the Basic I/O Monitor may be run in the 
ADVANCED system environment) . 

1.2 HARDVJARE REQUIREMENTS 

The minimum equipment configuration for the employment of the ADVANCED 
Software System is that of the Basic 15/20 system as illustrated in 
Figure 1-2. 

1.3 MONITOR SYSTEMS 

Monitor systems simplify the handling of input/output functions and 
facilitate the creation, debugging, and use of USER programs. They 
allow overlapped input/output and computation, simultaneous operation 
of a number of asynchronous peripheral devices, and (in the case of the 
ADVANCED Monitor) device-independent programming, while freeing the 
user from the need to create device-handling subroutines. The Monitor, 
operating in conjunction with the Input/Output Programming System (lOPS) 
provides a complete interface between the user’s programs and the 
peripheral hardware. 
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Figure 1-1 ADVANCED Monitor 
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Figure 1-2 PDP-15/20 System Equipment 

Configuration (Basic) 


1.3.1 ‘ADVANCED Monitor 

The ADVANCED Monitor Software System includes all of the facilities of 
the BASIC I/O Monitor (Paper Tape) plus routines to accept and act 
upon teleprinter keyboard commands, the ability to dynamically modify 
I/O device assignments for a program, and the facilities for automatically 
storing, calling, loading, and executing system and user programs. 

With the ability to alter I/O assignments, this Monitor brings true 
device independence to the user. Programs may be modified simply and 
quickly to operate on any configuration, and additions to (or deletions 
from) existing hardware need not result in program reassembly or recom- 
pilation. 

The Monitor also frees the user from the problems of tape or card 
handling. Programs can be created, stored, retrieved, loaded, debugged, 
and operated at the keyboard console. Both system and user programs 
can be called from the mass storage device with a few simple keyboard 
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commands. The Monitor also has a batch processing capability that allows 
user commands to originate from the paper tape reader or card reader in- 
stead of from the teleprinter, thus permitting many programs to be run 
without operator intervention. 


1.4 INPUT/OUTPUT PROGRAMMING SYSTEM (lOPS) 

The Input/Output Programming System (lOPS) consists of an I/O control 
routine (CAL handler) and individual hardware device handling routines 
(device handlers) that process file and data level commands to the device. 
These handlers exist for all standard peripherals (see Section 5.4). 

The CAL handler accepts user program commands and transfers control to 
the appropriate device handlers. These device handlers are responsible 
for transferring data between the program and I/O devices, for initiating 
the reading or writing of files, for opening and closing files, and for 
performing all other functions peculiar to a given hardware device. 

They are also responsible for ignoring functions which they are incapable 
of handling; for example, trying to rewind a card reader. All device 
handlers operate either with or without the Automatic Priority Interrupt 
(API) option. 

1.5 SYSTEM PROGRAMS 

In addition to lOPS and the ADVANCED Monitor, the ADVANCED Software System 
contains the following language and utility programs : 


FOCAL - Algebraic Language Interpreter (DEC-15-KJZB-D) 

FORTRAN IV - Compiler, Object Time System, and Science 
Library (DEC-15-KFZB-D) 

MACRO-15 - PDP-15 Assembler (DEC-15-AMZB-D) 

DDT - Dynamic Debugging Technique 

EDIT - Text Editor 

EDITVP - Text Editor for VP15A Storage Tube Display 

PIP - Peripheral Interchange Program 

Linking Loader - Loads Relocatable Programs 

CHAIN - Program to Construct System of Core Overlays I 

EXECUT - Program to Supervise Execution of CHAIN 
Built Overlay System 

SGEN - System Generator 

DUMP - Dump Program 

PATCH - System Patch Program 

SRCCOM - Source Compare Program 

DTCOPY - High-Speed 8K DECtape Copy Program ^ 

8TRAN - PDP8 to PDP-15 Translator (bEC-15-ENZA-D) 


(DEC-15-YWZA-D) 
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The following special purpose utility programs are also available: 

RFSAVE - DECdisk/DECtape Save 

MTSAVE - DECdisk/Magtape Save \ (DEC-15-YWZA-D) 

MTDUMP - Magnetic Tape Dump J 

1.5.1 FOCAL Programs 

FOCAL (Formulating On-line Calculations in Algebraic Language) operates 
in on-line conversational mode, using natural language and arithmetic 
terms to establish a simplified environment for the computer-aided 
solution of business and scientific ^arithmetic problems. Included in 
FOCAL are such features as: 

1. Device independence; 

2. Linkage to assembly language (MACRO) routines to establish 
a user library of commonly used functions; 

3. Use of COMMON to facilitate chaining in the same manner 
as FORTRAN IV. 

1.5.2 FORTRAN IV Compiler 

The PDP-15 FORTRAN IV compiler is a two-pass system that accepts state- 
ments written in the FORTRAN IV language and produces a relocatable 
object program capable of being loaded by the Linking Loader. It is 
completely compatible with USA FORTRAN IV, as defined in USA Standard 
X3. 9-1966, with the exception of the following features, which were 
modified to allow the compiler to operate in 8192 words of core storage: 

a. Complex arithmetic is not legal. 

b. Adjustable array dimensions are not allowed at source 
level, but may be implemented by calling dimension- 
adjustment subroutines provided in the Science Library. 

c. Blank Common is treated as named Common except when the 
object program is used in chaining. 

d. The implied DO feature is not included for the DATA 
statement . 

e. Specification statements must be strictly positioned 
and ordered. 

The FORTRAN IV compiler operates with the program interrupt or API 
facilities enabled. It generates programs that operate with the 
Program Interrupt (PI) or Automatic Priority Interrupt (API) enabled, 
and can work in conjunction with assembly language programs that 
recognize and service real-time devices. Subroutines written in either 
FORTRAN IV or MACRO-15 assembly language can be loaded with and called 
by FORTRAN IV main programs. Comprehensive source language diagnostics 
are produced during compilation, and a symbol table is generated for 
use in on-line debugging with DDT. 
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There are three versions of the FORTRAN IV compiler: (1) F4, the basic 
compiler; (2) f 4I, a compiler which permits DECtape I/O in an 8K system; 
and (3) f 4S, a more powerful version of F4 which has fewer restrictions 
and an expanded diagnostic capability. 

1.5.3 MACRO Assembler 

The MACRO Assembler provides users with highly sophisticated macro 
generating and calling facilities within the context of a symbolic 
assembler. 

Some of the prominent features of MACRO include; 

a. The ability to: 

(1) define macros 

(2) define macros within macros (nesting) 

(3) redefine macros (in or out of macro definitions) 

(4) call macros within macro definitions 

(5) have macros call themselves (recursion) 

(6) combine three input files for one assembly 

b. Conditional assembly based on the computational results 
of symbols or expressions 

c. Repeat functions 

d. Boolean manipulation 

e. Optional octal, symbolic, and cross-reference listings 

f. Two forms of radix control (octal, decimal) and two 
text modes (ASCII and 6-bit trimmed ASCII) 

g. Global symbols for easy linking of separately assembled 
programs 

h. Choice of output format; relocatable, absolute binary 
(check summed) , or full binary capable of being loaded 
via the hardware READIN switch 

i. Ability to call input/output system macros that expand 
into lOPS calling sequences 

A shorter version of the assembler (MACROI) is available for users 
with 8K systems which permits DECtape input and output. 

1.5.4 Dynamic Debugging Technique (DDT) Program 

DDT provides on-line debugging facilities within the ADVANCED Software 
System, enabling the user to load and operate his program in a real- 
time environment while maintaining strict control over the running of 
each section. DDT allows the operator to insert and delete breakpoints, 
examine and change registers, patch programs, and search for specific 
constants or word formats. 
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The DDT breakpoint feature allows the insertion and simultaneous use of 
up to four breakpoints, any or all of which may be removed with a 
single keyboard command. The search facility allows the operator to 
specify a search through any part or all of an object program with a 
printout of the locations of all registers that are equal (or unequal) 
to a specified constant. This search feature also works for portions 
of words as modified by a mask. With DDT, registers may be examined and 
modified in either instruction format or octal code, and addresses may 
be specified in symbolic relative, octal relative, or octal absolute. 
Patches may be inserted in either source language or octal. 

1.5.5 Text Editor Programs, EDIT and EDITVP 

The Text Editor of the ADVANCED Software System provides the ability 
to read alphanumeric text from any input device (paper tape reader, 
card reader, disk, DECtape, magnetic tape, etc.), to examine and correct 
it, and to write it on any output device. It can also be used to 
create new symbolic programs. 

The Editor operates on lines of symbolic text delimited by carriage 
return (CR) or ALT MODE characters. These lines can be read into a 
buffer, selectively examined, deleted or modified, and written out. 

New text may be substituted, inserted, or appended. 

The program EDITVP is similar to EDIT except that it permits the text 
to be displayed on the VP15A storage tube. 

1.5.6 Peripheral Interchange Program (PIP) 

The primary function of PIP is to facilitate the manipulation and 
transfer of data files from any input device to any output device. It 
can be used to refresh mass storage file directories; list file 
directory contents; delete, insert, segment, or combine files; perform 
code conversions; transfer files; or copy the entire contents of mass 
storage units. 

1.5.7 Linking Loader 

The Linking Loader loads any FORTRAN IV or MACRO object program which 
exists in relocatable format (or absolute format, if pseudo-ops .ABS 
and .FULL are not used) . Its tasks include loading and relocation 
of programs, loading of called subroutines, retrieval and loading of 
implied subroutines, and building and relocation of the necessary 
symbol tables. 



1.5.8 8 to 15 Translator (8TRAN) 

i . ■ 

This program is used as an aid in translating programs written for the 
Digital PDP-8 computer into MACRO-15 form. The translator does not 
necessarily produce an executable program, but translates a major portion 
of the PDP-‘8 code into equivalent MACRO-15 code and indicates those areas 
of the 8 program which must be reviewed and processed by the programmer. 

1.5.9 System Generator 

The System Generator (SGEN) is a standard system program used to create 
new system tapes. With it, the user can tailor his system to his 
installation's needs and specify standard input and output devices, 
memory size, and special I/O and central processor options present. 

1.5.10 Dump Program 

This system program gives the user the ability to output on any listing 
device specified core locations that have been preserved on a bulk 
storage file via the CTRL Q Keyboard Monitor dump command. It also 
provides the ability to dump areas of mass storage (e.g., a DECtape 
block) onto any listing device. 

1.5.11 Library Update Program 

This system program gives the user the capability to examine and update 
the binary library files on mass storage devices. 

1.5.12 System Patch Program 

The System Patch Program is used to make corrections to the binary 
version of non-relocatable system programs on the system device, to 
examine and change any word in any DECtape or DECdisk block, or to 
convert relocatable binary programs into system programs (SYS files) . 

1.5.13 CHAIN and EXECUTE Programs 

The programs CHAIN and EXECUTE provide the user with the ability to 
construct and run a system of core overlays in the ADVANCED Monitor 
environment. 

1.5.14 Source Compare Program (SRCCOM) 

The SRCCOM program compares any two symbolic programs (lOPS ASCII) and 
indicates their differences. This program is useful for program 
identification and/or verification, proofing an edited program, com- 
parison of old and new versions of the same program, etc. 

1.5.15 DECtape Copy (DTCOPY) 

This program, designed for 8K system users, permits high speed copying 
of DECtape onto DECdisk units. 
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CHAPTER 2 


THE ADVANCED MONITOR ENVIRONMENT 


2.1 MONITOR FUNCTIONS 

The ADVANCED Monitor simplifies the task of programming I/O functions 
by providing an interface between system or user programs and the 
external world of I/O devices. The Monitor, by means of lOPS and 
Program Interrupt (PI) or optional Automatic Program Interrupt (API) , 
permits simultaneous operation of multiple I/O devices along with over- 
lapping computations. 

2.1.1 General I/O Communication 

The general communication required to accomplish an I/O task is the same 
for all three Monitor systems (see Figure 2-1) . A system or user 
program initiates an I/O function by means of a Monitor command (system 
macro) , which is interpreted by a CAL handler^ within the Monitor as a 
legitimate I/O call. The I/O call includes a logical I/O device 
number as one of its arguments. The Monitor establishes the logical/ 
physical I/O device association by means of its Device Assignment Table 
(.DAT) . When this has been accomplished, the Monitor passes control to 
the appropriate device handler subroutine to initiate the I/O function 


DATA 
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Figure 2-1 General I/O Communication 
in Monitor Environment 


^ Refer to the PDP-15 Users' Handbook Vol. 1, (DEC-15-H2DA-D) for a 

description of the CAL handler. 
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and return control to the system or user program. The system or user 
program retains control until an interrupt (PI or API) occurs, at which 
time it relinquishes control to the device handler to perform and/or 
complete the specified I/O function. Computation or other processing 
can be performed by the system or user program while waiting for an 
interrupt. This feature allows the programmer to make optimum use of 
available time. 

2.1.2 Command, Control, and Data Flow 

Figure 2-2 illustrates the data flow and general organization of the 
ADVANCED Monitor. As shown, the user can initiate a command via the 
teleprinter . 

In the ADVANCED Monitor environment, an expanded set of keyboard com- 
mands can be interpreted by a Keyboard Listener (.KLIST) and acted upon 
by a Monitor Command Decoder (.MCD). This feature greatly extends the 
capabilities of the Monitor and provides the user with a large 
repertoire of keyboard commands. The .KLIST and .MCD programs are 
nonresident in the sense that they are overlaid by user and system 
programs . 

Each system or user program must internally set up line buffers (except 
when using Dump mode, discussed later) to be used in transmitting data 
to or from the external environment. Each line buffer of n words con- 
sists of a two-word header (referred to as a header word pair) and n-2 
words of data. The system or user program can exercise control on out- 
put by modifying the header word pair, or it can verify on input by 
examining the header word pair. The use of line buffers is discussed 
in more detail later in this chapter. 

ADVANCED Monitor I/O commands (system macros M are written as part of 
the system or user program. In FORTRAN IV source programs, these com- 
mands are in the form of READ and WRITE statements (refer to the 
FORTRAN IV Manual, DEC-15-KFZA-D) . These statements are translated by 
the compiler into the proper calling sequences for the FORTRAN Object 
Time System which provides the required monitor calls at execution time. 
In MACRO source programs. Monitor I/O commands are written as system 
macros within the system or user program. These system macros are 
expanded at assembly time, and include a CAL initiated monitor call 
that contains the logical device number as one of the arguments. 


^System Macros are predefined system commands which are equivalent to 
a specific sequence of machine instructions. Refer to Chapter 3 for a 
description of the ADVANCED system macros. 
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Figure 2-2 Command, Control, and Data Flow in Monitor Environment 














At execution time, monitor calls are processed by the CAL Handler within 
the Monitor. Non-I/O functions are then further processed by the Monitor 
Control Routine, and I/O functions are processed by the I/O Control 
Routine (see Figures 2-2 and 2-3) . A complete description of each of 
these commands is given in Chapter 3. If the original command involved 
is an I/O function, the I/O Control Routine checks the Device Assign- 
ment Table to associate the logical I/O device (specified by the system 
macro) to a physical I/O device. 

In the ADVANCED Monitor environment, device associations can be per- 
manently modified at System Generation time, or dynamically modified 
by means of the ASSIGN keyboard command just prior to loading a system 
or user program. This capability adds true device independence to the 
Monitor systems. 



Function 



Code 

Command 


1 

.INIT 


2 

.DLETE, .RENAM, and .FSTAT 


3 

.SEEK 

Functions 

4 

.ENTER 

processed 
by I/O 

5 

. CLEAR 

Control 

6 

.CLOSE 

Routine 

7 

. MTAPE 


10 

.READ 


11 

.WRITE 


12 

.WAIT and .WAITR 


13 

.TRAN 

Functions 

14 

.TIMER 

processed 
by Monitor 

15 

.EXIT 

Control 

Routine 

16 

. SETUP 


Figure 2-3 ADVANCED Monitor Commands 
and Function Codes 


When the logical/physical I/O device association has been established, 
the Monitor passes control to the appropriate I/O device handler, which 
initializes itself, initiates I/O, and returns control to the system or 
user program. As mentioned previously, the system or user program re- 
tains control until the specified device causes an interrupt (PI or API) 
At this point, it relinquishes control to the device handler to continue 
or complete the specified I/O operation. In either case, control is 
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returned to the system or user program at the point where it was inter- 
rupted. The system or user program, by means of a .WAIT (or .WAITR) 
system macro (described in Chapter 3 ) , can determine whether an input 
or output operation has been completed. If the transfer of data from 
or to the system or user program line buffer has been completed, program 
execution continues; if the transfer has not been completed, control is 
returned to the .WAIT macro or to the address specified in the .WAITR. 

Additional buffering is provided by the individual device handlers as 
required. All device handlers are non-resident in the sense that only 
those handlers required by the system or user program are loaded into 
core . 

2.2 LINE BUFFERS 

As mentioned in the preceding general description of the Monitor 
environment, each system or user program must internally set up line 
buffers to be used in transmitting data to or from the external environ- 
ment. An exception to this rule is when data is transmitted in the 
Dump mode (described in paragraph 2.3.3) or when the .TRAN command is 
used (see paragraph 3.1.15). Each line buffer of n words (always even) 
should be set up to consist of a two-word header (termed a header word 
pair) followed by n-2 words of data, as shown in Figure 2-4. 


Word 0 First Word of Line Buffer Header 

Word 1 Second Word of Line Buffer Header 

Word 2 First Word of Data Area 

1 i 

Word n-1 Last Word of Data Area 

Figure 2-4 Line Buffer Structure 

A system or user program should contain at least one line buffer for 
each device that is to be used simultaneously. This buffer is used to 
set up output lines before transmittal to an output device, or to 
receive input lines from the associated input device. The Monitor 
accepts commands (system macros) from system or user programs to initiate 
input to the line buffers and to write out the contents of line buffers. 
Complete descriptions of these commands are given in Chapter 3. Line 
buffers are internal to, and must be defined by, each system or user 
program. The header word pair within a line buffer is detailed in 
Figure 2-5 and should be studied carefully. The .BLOCK pseudo operation 
may be used to reserve space for a line buffer. A tag is required to 
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allow referencing by individual .READ and .WRITE macros. For example: 

.DEC 

LINEIN .BLOCK 52 /creates 52-word line 

/buffer named LINEIN. 

LINOUT .BLOCK 52 /creates 52-word line 

/buffer named LINOUT. 

Before output ^ the user must set the appropriate word pair count in 

bits 1 through 8 of word zero in the line buffer if it has not already 

been set by a device handler on input. This count overrides the word 
count passed to lOPS by the .WRITE macro. (The word count must still 
be specified in the .WRITE macro for each data mode; however, it only 
has meaning in Dump mode in which there is no header word pair.) In 
lOPS binary mode (discussed in Paragraph 2. 3. 1.2), bits 9 through 11 
should be set to 101 if the output will ultimately be on cards. The 
checksum word, the second word in the header, need not be set by the 
user since checksums are computed by lOPS. 

Before input , the user should not be concerned with the header word 
pair since they will be set by lOPS to enable the user to determine 
what has happened after input has terminated. 

On input , the word count specified in the .READ macro is used by lOPS 
to determine the maximum number of locations to be occupied by the data 
being read. If the word count is exceeded before input is terminated, 
or if there is a parity or checksum error, lOPS sets the appropriate 
validity bits in header word 0 to indicate the error. 

After input , the user should check the validity bits in word 0 of the 
line buffer header to determine if the data was read without error. 

If multiple errors are detected, priority is given to a parity error 
over a checksum error. lOPS ignores checksum errors on binary input if 
bit 0 of word 0 of the line buffer header is set to 1. lOPS sets the 
I/O mode bits (bits 14 through 17 of word 0 of the line buffer header) 
to; 6 (OllO^) if it senses a physical end-of-medium (such as end-of- 
tape in the paper-tape reader) , or 5 (OIOI 2 ) if it senses a logical end- 
of“f iles . 

When choosing a word count (that is, the maximum line buffer size) to 
specify in system macros, both the set of. possible devices and the mode 
of data transmission must be considered. The maximum line buffer sizes 
(including 2-word header) for standard peripheral devices, along with 
applicable data modes, are listed in Table 2-1. 
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1 


HEADER. 
WORD 0 
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ON Bl NARY INPUT 


1 1 
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^ I/O MODE 

_J 
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J \ 1 1 1 

1 \ ^ 1 

1 1 

1 1 1 L- , 



WORD PAIR COUNT, INCLUDING 
HEADER WORD PAIR 


UNUSED 


VALIDITY bits; 

00 = DATA CORRECT 

01 = PARITY ERROR 


10 = CHECKSUM ERROR 
' * = BUFFER overflow 


I/O MODE. 

0000 = lOPS binary 

000 1 = IMAGE BINARY 

001 0 = lOPS ASCII 

001 1 » IMAGE ALPHANUMERIC 


0100= DUMP 
0 101 = EOF (LOGICAL) 

0 110= EOM (PHYSICAL) 
0 111 = TAPE LABEL 


0 


17 


HEADER, 
WORD 1 


J I 1 I I 1 I I I I I I ^ I I L 




■V 


J 


CHECKSUM 

TWO’S COMPLEMENT OF HEADER WORD 0 PLUS DATA 
WORDS (0= CHECKSUM NOT COMPUTED) 
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Figure 2-5 Format of Header Word Pair 


2.3 DATA MODES 

The Input/Output Programming System (lOPS) allows data transmission to 
or from a system or user program in six different modes. 

Mode Code^ 


lOPS Binary 
Image Binary 
lOPS ASCII 
Image Alphanumeric 
Dump 

9 -Channel Dump 


0 

1 

2 

3 

4 

5 (Magtape only; 
5.3.10, 5.4.6, 


see sections 
and 5. 4.6.3 (f) .) 


^Bits 14 through 17 of Header Word 0, specified by system macro and 
set by lOPS. 
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Table 2-1 


Maximum Line Buffer Sizes 


Device 

Maximum 

Line 

Buffer 

Size 

Data^ 

Modes 

Modes 

PR (paper tape reader) 


All 

34^QSuf f icient if mode 2 only. 

Headers accepted for mode 0 ; 
headers generated for modes 

1, 2, 3. 

PP (paper tape punch) 

“lO 

All 

34^q sufficient if mode 2 

only. Headers output for 
mode 0 only. 

TT (teleprinter) 


2 , 3 only 

Allows for characters. 

Headers generated on input. 
Headers not generated on 
output. 

CD (card reader) 


2 only 

Headers generated for 
mode 2 . 

LP (line printer) 

“lO 

2 only 

Allows for 125 ^q characters. 

No headers output. 

VP (Display) 


2 , 3 only 

Allows for characters. 

Mode 3 requires 80^^ word 
buffer. No Header output. 

DT (DECtape) 

255io 

All 

lOPS and image modes allow 
for several line buffers 

MT (magnetic tape) 


All 

(logical records) per 
physical block. 

DK (DECdisk) 

P55io 

All 

■ — - ■ - . — ... ■ ■ ■ 


^See Paragraph 2,3 above. 











2.3.1 lOPS Modes 


The two lOPS data modes consist of TOPS ASCII and lOPS binary, as shown 
in Figure 2-6 on paper tape and described in the following paragraphs. 


DIRECTION 
OF TAPE 
MOVEMENT 


TAPE CHANNEL 

8 7 6 5 4 3 2 1 

FEED 

OOOOOOOOO 
OOOOOOOOO 
OOOOO OOOO 
OOOOOOOOO 


4 ^ 




lOPS ASCII 




7-BIT ASCII CODE 
PARITY BITIEVEN PARITY) 


DIRECT I ON 
OF TAPE 
MOVEMENT 


TAPE CHANNEL 

7 6 5 4 3 2 

FEED 

• OOOOoOOO 

• OOOOoOOO 

• OOOOoOOO 

• OOOOoOOO 


IS* 6 -BIT BYTE 
2nd 6 -BIT BYTE 
3 rd 6 -BIT byte 



Figure 2-6 lOPS Mode Data on Paper Tape 


2. 3. 1.1 lOPS ASCII - Seven-bit ASCII is used by lOPS to accommodate the 
entire 128-character revised ASCII set (Appendix A) . All alphanumeric 
data, whatever its original form on input (ASCII, Hollerith, etc.) or 
final form on output, is converted internally and stored as 5/7 ASCII. 
"5/7 ASCII" refers to the internal packing and storage scheme. Five 
7-bit ASCII characters are packed in two contiguous locations, as 
shown in Figure 2-7, and can be stored as binary data on any bulk 
storage device. Input requests involving lOPS ASCII should be made 
with an even word count to accommodate the paired input. 

ASCII data is ordinarily input to or output from lOPS via the tele- 
printer or paper tape, although it may exist in 5/7 ASCII form on any 
mass storage device. lOPS ASCII is defined as a 7-bit ASCII character 
with even parity in the eighth (high order) bit, in keeping with USA 
standards. lOPS performs a parity check on input of lOPS ASCII data 
prior to the 5/7 packing. On output, lOPS generates the correct parity. 
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Figure 2-7 5/7 ASCII Packing Scheme 


Non-parity lOPS ASCII occurs in data originating at a Model 33, 35, 
or 37 Teletype^ , without the parity option. This data always appears 
with the eighth (high order) bit set to 1. Apart from parity checking, 
the lOPS routines handle lOPS ASCII and non-parity lOPS ASCII data 
identically. 

An alphanumeric line consists of an optional initial form control 
character (line feed, vertical tab, or form feed) , the body of the 
line, and a carriage return (CR) or ALT MODE. CR (or ALT MODE) is a 
required line terminator in lOPS ASCII mode. Control character scanning 
is performed by some device handlers for editing or control purposes. 
(See Section 5.4 for effects of control characters on specific devices.) 

2. 3. 1.2 lOPS Binary - lOPS Binary data is blocked in an even number of 
words, with each block preceded by a two-word header. On paper tape 
(see Figure 2-6), lOPS binary uses six bits per frame, with the eighth 
channel always set to 1, and the seventh channel containing the parity 
bit (odd parity) for channels 1 through 6 and channel 8. The parity 
feature supplements the checksumming as a data validity provision in 
paper tape lOPS binary. 

2.3.2 Image Modes 

Image Mode data is read, written, and stored in the binary or alpha- 
numeric form of the source or terminal device, one character per word, 
as shown in Figures 2-8 and 2-9. No conversion, checking, or packing 
is permitted. 


^Teletype is a registered trademark of the Teletype Corporation. 
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Figure 2-8, Image Mode Data On Paper Tape 


—WORD PAIR COUNT 

8 17 


1 

2 


CHECKSUM 

A 

B 



V 

0 


HEADER 
WORD PAIR 


ABC ^ 

IN 5/7 ASCII 


lOPS ASCII 



09-0221 


Figure 2-9, lOPS ASCII And Image Alphanumeric Data In 
Line Buffers And On Mass Storage Devices. 









2.3.3 Dump Mode 

Dump mode data is always binary. Dump mode is used to output from or 
load directly into any core memory area, bypassing the use of line 
buffers. Each dump mode statement has arguments defining the core 
memory area to be dumped. Dump mode is normally used with bulk storage 
devices, although it is also possible to use it with paper tape output 
and input. 


Table 2-2 


Input/Output Data Mode Terminators 


DATA MODE 

INPUT 

OUTPUT 

lOPS ASCII 

Carriage RETURN 

ALT MODE 

Word Pair Count^ 

EOM 

Word Count^ 

EOF^ 

Carriage RETURN 

ALT MODE 

Word Pair Count^ 

lOPS Binary 

Word Pair Count 

EOM 

Word Count^ 

EOF^ 

Word Pair Count 

Image Alpha- 
numeric 

Image Binary 

Word Count 

EOM 

EOF^ 

Word Pair Count 

Dump^ 

Word Count 

EOM 

EOF^ 

Word Count 


^Bulk storage only. 

^If word count is exceeded before a terminator is en- 
countered, TOPS sets bits 12 and 13 of Header Word 0 to 
3 (Buffer Overflow) . 

^If the Word Pair Count is 1 or less, the line is ignored; 
if greater than 1, ignore the count and accept Carriage 
RETURN or ALT MODE (non-file-oriented devices only) . Bulk 
storage devices require a Word Pair Count greater than 1 
and less than 111 ^, otherwise an TOPS 27 error will occur. 

O 

“*9 -Channel Dump data mode is available for magnetic tape; 
refer to section 5.4.6.3(f) for a description of this data 
mode . 
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2.4 SYSTEM TABLES 

System tables used by each of the Monitor systems include the Device 
Assignment Table (.DAT), and the System Communication Table (.SCOM). 

These tables are discussed in the following paragraphs. 

2.4.1 Device Assignment Table (.DAT) 

Both FORTRAN IV and MACRO coded user programs, as well as the system 
programs, specify I/O operations with commands to logical I/O devices. 

One of the Monitor's functions is to relate these logical units to 
physical devices. To do this, the Monitor contains a Device 
Assignment Table (.DAT) which has "slot" numbers that correspond directly 
to logical I/O device numbers. Each .DAT slot contains the physical 
device unit number (if applicable) along with a pointer to the appro- 
priate device handler. 

All I/O communication in the Monitor environment is accomplished by 
the logical/physical device associations provided by the Device Assign- 
ment Table. 

2.4.2 System Communication Table (.SCOM) 

The System Communication Table (.SCOM) provides a list of registers that 
can be referenced by the Monitor, lOPS, and system programs. A complete 
list of .SCOM entries, and the purpose of each, is given in Table 2-3. 

The System Communication Table begins at location 100 g. 

2.5 SPECIFYING DEVICES USED TO LINKING LOADER. 

When writing a MACRO program that uses Monitor commands (system macros) , 
it is necessary to use the .lODEV pseudo-operation somewhere in the 
program to specify to the Linking Loader which logical device numbers 
or .DAT slots are to be used. The JODEV pseudo-op causes a code to be 
generated that is recognized by the Linking Loader and used to load 
device handlers associated with specified .DAT slots. The .lODEV 
pseudo-op has the following form: 

.lODEV 3, 5, 6 

where the MACRO program containing this statement can use .DAT slots 
3, 5, and 6. An error message is generated if a slot called for by 
a program is unassigned. 

FORTRAN IV programs cause the compiler to generate the appropriate 
Linking Loader code based on the units specified in READ and WRITE 
statements. Note that use of a constant to specify an I/O unit in a 
FORTRAN program will cause only the handler assigned to the correspond- 
ing .DAT slot to be loaded; whereas if a variable is used, handlers 
will be loaded for all positive .DAT slots that have handlers assigned. 
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Word 


• SCOM 

. SCOM+1 
. SCOM+2 
. SCOM+3 
.SCOM+4 


.SCOM+5 

.SCOM+6 


.SCOM+7- 

.SCOM+12 

.SCOM+16 
.SCOM+1 7 
.SCOM+20 


Table 2-3 

System Communication Table (.SCOM) Entries 


Purpose 






First free register below resident portion of System 
Bootstrap. 


First free register above resident monitor (constant) 
Lowest free register available to user or system program 


Highest free register available to user or system program 


Hardware options available; 


Bit 0 
Bit 1 
Bit 2 
Bit 3 
Bit 4 
Bit 5 
Bit 6 
Bit 7 
Bit 8 
Bit 9 
Bit 10 
Bit 11 
Bits 12 
and 13 


1 = API 
1 = EAE 

1 = TTY = 35/37 (0 = KSR33) 

1 = Non-resident monitor in core 

Reserved 

Reserved 

1 = 9-channel, 0 = 7-channel Magnetic Tape 

1 = Page Mode Operation, 0 = Bank Mode Operation 

1 = No IQ Area 

Reserved 

Reserved 

1 = Bank Mode Operation 
Line Printer Column Size 

00 = Unknown 

01 = 80 
10 = 120 
11 = 132 


Bit 14 1 = Background/Foreground System 

Bit 15-17 Reserved 


System program starting location 

User starting location (bits 3 through 17) , and 

Bit 0 1 = DDT Load 

Bit 1 1 = G Load 

Bit 2 1 = No-symbol-table Load 

Device numbers of Linking Loader's devices. These are used 
to avoid loading user handlers already in core for the 
Loader itself. Also used for file name with EXECUTE. 

Transfer vectors associated with API software level channel 
registers 40 through 43g. 

Contains PC on keyboard interrupts . 

Contains AC on keyboard interrupts. 

Extra 4K System Information 

Bit 0 1 = Extra 4K on System 

Bit 3-17 First free register in extra 4K 


Magtape Status Register 
(Reserved for Magtape Handler) 

Address of Device Assignment Table (.DAT) 


.SCOM+21 
.SCOM+2 2 
.SCOM+2 3 







2.6 RESERVED WORD LOCATIONS 

Word locations J3 through 77 are dedicated systems locations and cannot 
be employed by the user. The contents of these locations are described 
in Table 2-4. 


Table 2-4 


Reserved Address Locations 


ADDRESS 

USE 



Page Mode 

Bank Mode 



Stores the contents of the extended PC, link, extend 
mode status, and memory protect status during a program 
interrupt. 


1 

JMP to Skip Chain 

EEM (Enter Extend Mode) 
instruction for compatibil- 
ity with PDP-9 systems. 


2 

Stores system tape 
(Bank or Page) indicator 
during Teletype inter- 
rupts . 

JMP to Skip Chain 


3 

.MED, entry to Monitor Error Diagnostic routine 


4 

JMP to error handler 

(Same) 


5 

(Not used in Page 

Mode . ) 

Stores system type (Bank 
or Page) indicator during 
Teletype interrupts. 


6 

Used for API ON/OFF indicator in both systems. 


7 

Stores real time clock 
count. 

(Same) 

10 

- 17 

Autoindex registers 

(Same) 


20 

Stores the contents of the extended PC, link, extend 
mode status, and memory protect status during a 
program interrupt. 


21 

JMP to CAL handler 

(Same) 

22 

- 37 

Seven pairs of word counter-current address registers for 
use with 3-cycle I/O device data channels. 

40 

- 77 

Store unique entry instructions for each of 32^^ automatic 
priority interrupt channels. 
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CHAPTER 3 


SYSTEM MACROS 


3 . 1 INTRODUCTION 

The MACRO-15 assembler permits the development of instructions called 
"macros" which, when used as a source statement, can cause a specific 
sequence of instructions to be generated in the object program. For 
example, consider the following sequence: 

-*|LAC -^A 
-^TAD 
-^DAC -*|C 

-^LAC -^D 
-*|TAD -^E 
-^DAC -*|F 

The assembler enables the following basic instruction sequence to be 
represented in the source program by a single macro instruction. To 
employ macros, it is first necessary to define the desired coding 
sequence with dummy arguments as a macro instruction; the defined 
instruction may then be referenced by name, together with the real 
arguments, as a single statement each time the equivalent coding 
sequence is needed in the program. Refer to the PDP-15 MACRO-15 
Assembler manual (DEC-15-AMZB-D) for a complete description of macros. 

-HlaC -*|x 

-^TAD _^y NOTE: x, y, and z are dummy arguments. 

-*j DAC z 

The ADVANCED Monitor provides the user with access to a set of pre- 
defined macros (referred to as system macros) as a programming con- 
venience. These system macros are referenced (called) in user 
programs by writing a statement comprising an assigned macro name 
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followed, if needed, by a list of real arguments separated by commas 
Macro statements are terminated by either a space , a tab ( H)- or 

a carriage return (^ ) . For example: 

.SEEK -^7, NAME 

3.1.1 Summary of ADVANCED Monitor System MACROS. 

The following is a summary of the System MACROS which are recognized by 
the PDP-15 ADVANCED Monitor. Individual detailed descriptions are 
provided in paragraphs 3.1.2 through 3.1.17. 


Name 


.INIT 
. DLETE 
.RENAM 
.FSTAT 

• SEEK 

.ENTER 
. CLEAR 

.CLOSE 
. MTAPE 

.READ 

.WRITE 

• WAIT 

.WAITR 

.TRAN 


.TIMER 

.EXIT 


Initializes the device and device handler. 

Deletes file from file-oriented device. 

Renames file on file-oriented device. 

Checks presence of file on file-oriented device. 

Locates file on file-oriented device and 
begins data input. 

Primes file-oriented device for output. 

Initializes file structure on file-oriented 
device . 

Terminates use of a file. 

Provides special commands for industry 
compatible magnetic tape. 

Transfers data from the device to the user's 
line buffer. 

Transfers data from the user's line buffer 
to the device. 

Checks the availability of the user's line 
buffer and waits if busy. 

Cheeks availability of the user's line buffer 
and provides transfer address for busy return. 

Reads or records user specified block on bulk 
storage devices, providing the user with the 
capability to determine the structure of the 
files on the device. 

Calls and uses Real Time Clock option. 

Returns control to the Monitor. 


The first seven MACROS listed above (excluding .INIT) apply to file- 
oriented devices (i.e., DECtape, DECdisk, and MAGtape) ; they are either 
ignored or treated as illegal (depending upon the function) by non- 
file-oriented functions of magnetic tape (REWIND, BACKSPACE, etc.). 

If these non-file-oriented commands are issued to file-oriented devices, 
they are either ignored or flagged as errors. Two .MTAPE commands 
(REWIND TO LOAD POINT and BACKSPACE RECORD) , however, may be used with 
DECtape and DECdisk with the appropriate handler version. When so used. 
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these conunands preclude the use of .SEEK or .ENTER. Refer to paragraph 
5.4 for specific device handler characteristics. 

3.1.2 .INIT (Initialize) 


FORM: INIT a, F, R 

VARIABLES: a = Device Assignment Table (.DAT) slot number (in octal 

radix) 

F = File Type: 0 = Input File 

1 = Output File 

R = User Restart Address^ (should be in every .INIT state- 
ment) 


EXPANSION : LOG 

LOG + 1 


LOG + 2 
LOG + 3 


CAL + F^_g + ag_^^ 


/The GAL handler will place the unit 
/number (if applicable) associated 
/with .DAT slot ^ into bits 0 
/through 2 of this word^ . 


/Maximum size of line buffer 
/associated with .DAT slot a, for 
/example, 255^^ for DEGtape. ^ 


DESGRIPTION: The macro .INIT causes the device and device handler 

associated with .DAT slot a to be initialized. .INIT must be given 
prior to any I/O commands referencing .DAT slot a; a separate .INIT 
command must be given for each .DAT slot referenced by the program. 

Each initialized .DAT slot constitutes an open file to the device 
handler and must be .GLOSEd. Since a .DAT slot may refer to only one 
type of file (input or output) , only one file type specification (0 or 1) 
may be made in an .INIT statement. If a .DAT slot first references 
an input file, then an output file (or vice versa) , a second .INIT 
command must be executed to change the transfer direction prior to the 
actual data transfer command. 


3.1.3 . DLETE 

FORM: .DLETE a,D 

VARIABLES: a = .DAT slot number (octal radix) 

D = Starting address of three-word block of storage in 
user area containing the file name and extension of 

^Has meaning only for .INIT commands referencing slots used by the TTY 
(the last .INIT command encountered for any slot referencing the key- 
board or teleprinter takes precedence). When the user types iP, 
control is transferred to R. For example, the Linking Loader takes 
advantage of this feature to restart the system when a new medium has 
been placed in the input device (e.g., another paper tape in the 
reader. 

^Has no direct effect upon the user's program, but should be noted so 
that no attempt will be made to use LOG + 1 as a constant. 

^Size is returned by the handler so that the program, in a device- 
independent environment, can use it to properly set up line buffers. 
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the file to be deleted from the device associated with 
.DAT slot a. 

EXPANSION: LOG CAL + 1000 + 

LOG +1 2 /The CAL handler will place the unit 

/number associated with .DAT slot a 
into bits 0 through 2 of LOG + 1. 

LOG +2 D 

DESCRIPTION: . DLETE deletes the file specified by the file entry block 

at D from the device associated with .DAT slot a and retrieves the storage 
blocks released by that file. The contents of the AC will be 0 on return 
if the specified file cannot be found. 

3.1.4 .RENAM 

FORM: .RENAM a, D 

VARIABLES: a = .DAT slot number (octal radix) 

D = Starting address of two 3-word blocks of storage 

in user area containing the file names and extensions 
of the file to be renamed and the new name, 
respectively . 

EXPANSION: LOG CAL + 2000 4- 

LOG +1 2 /The CAL handler will place the unit 

/number associated with .DAT slot a 
/into bits 0 through 2 of LOG +1. 

LOG +2 D 

DESCRIPTION: .RENAM renames the file specified by the file entry 

block at D with the name in the file entry block at D + 3 on the 
device associated with .DAT slot a. The contents of the AC will be 
zero on return if the file specified at D cannot be found. 

3.1.5 . FSTAT 

FORM : . FSTAT a , D 

VARIABLES: a = .DAT slot number (octal radix) 

D = Starting address of three-word block of storage in 
user area containing the file name and extension of 
the file whose presence on the device associated 
with .DAT slot a is to be examined. 
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EXPANSION: LOG 


CAL + 3000 + a 


LOG +1 2 

LOG 4- 2 


9-17 

/The CAL handler will place the unit 
/number associated with .DAT slot a 
/into bits 0 through 2 of LOG + l.~ 


DESCRIPTION: .FSTAT checks the status of the file specified by the file 

entry block at D on the device associated with .DAT slot a. On return, 
the AC will contain the first block number of the file if found. The 
contents of the AC will be zero on return if the specified file is not 
on the device. It is recommended that .FSTAT be used prior to .SEEK, 
if the user prefers to retain program control when a file is not found 
in the directory. Otherwise, control is returned to the Monitor error 
routine to output an lOPS 13 error code on the teleprinter. 


3.1.6 .SEEK 


FORM: .SEEK a,D 

VARIABLES: a = .DAT slot number (octal radix) 

D = Address of user directory entry block 


EXPANSION: LOC 

CAL + 

LOC + 1 

3 /The CAL handler will place unit 

/number (if applicable) into bits 
/O through 2 . 

LOC + 2 

D 


DESCRIPTION: .SEEK is used to search the directory of file-oriented 

device a tor a desired file and to begin input for subsequent .READ 
commands. D is a pointer to (that is, the address of) a three-word 
entry in the user's program containing the file name and extension 
information. The device's file directory block is searched for a 
matching entry; if one is found, input of the file into the handler's 
internal buffer begins. If no matching entry is found, control is 
transferred to an error-handling routine in the Monitor, an error 
message is printed on the teleprinter, and the Monitor resumes control. 
Execution of the .FSTAT command allows the user to check the directory 
for a named file and to retain control if not found. 


The entry format in the user's file directory entry block (in core) 


Bits 0 through 2 of LOG + 2 must be set to zero prior to the execution 
of the CAL at LOG. On return, bits 0 through 2 of LOC + 2 will contain 
a code indicating the type of device associated with .DAT slot a. 

0 = Non-file-oriented devices 

1 = DECtape (file structuring) 

4 = Magnetic tape 

If the contents of the AC are 0 on return from .FSTAT (indicating that 
the file was not found) , bits 0 through 2 of LOC + 2 should be checked, 
because if they are still 0, the device was non-file-oriented. 
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is as follows; 



0 5 

6 11 

12 17 

D 

N 

A 

M 

D+1 

E 

0 

0 

D+2 

E 

X 

T 


File Name: up to six 6 -bit 
trimmed ASCII characters, 
padded, if necessary, with 
nulls ( 0 ) . 

File Name Extension: Up to 
three 6 -bit trimmed ASCII 
characters, padded with 
nulls. (The symbol @ produces 
a zero when using SIXBT.) 


The file name is essentially nine characters (six of file name and 
three of file name extension) ; the file-searching of the .SEEK command 
takes into account all nine characters. 

System programs, unless otherwise specified, use predetermined file 
name extensions in their operation. For example, if MACRO-15 wishes 
to .SEEK program ABCDEF as source input and the user has not specified 
an extension, it searches for ABCDEF SRC (ABCDEF, Source) . The 
binary output produced would be named ABCDEF BIN (ABCDEF, Relocatable 
Binary) , while the listings produced would be named ABCDEF LST (ABCDEF, 
Listing) . The Linking Loader, if told to load ABCDEF, would .SEEK 
ABCDEF BIN. FORTRAN IV is an exception to the above conventions in 
that it assumes the input file name extension is always SRC. 

3.1, 7 .ENTER 

FORM: .ENTER a, D 

VARIABLES: a = .DAT slot number (octal radix) 

D = Address of user directory entry block 

! 

EXPANSION: LOC CAL + ^ 9-17 

LOC +1 4 /The CAL handler will place the unit 

/number (if applicable) associated 
/with .DAT slot a into bits 0 
/through 2 . 

LOC +2 D 

DESCRIPTION: .ENTER is used to examine the directory of the device 
referenced by .DAT slot a to find a free four-word directory entry 
block in which to place the three-word block at D and one word of 
retrieval information when .CLOSE is later issued. Deletion of any 
earlier file with the same name and extension is performed by the 
.CLOSE macro. Control is transferred to the error handling routine in 
the Monitor to output an appropriate error message if there is no 
available space in the file directory at the time when .ENTER is 
executed . 
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3.1,8 . CLEAR 


FORM: .CLEAR a 

VARIABLES; a = .DAT slot number (octal radix) 

EXPANSION: LOC CAL + 

LOC +1 5 /The CAL handler will place the unit 

/number (if applicable) associated 
/with .DAT slot a into bits 0 
/through 2 . 

DESCRIPTION; .CLEAR is used to initiate the lOPS file structuring of 
the device referenced by .DAT slot a by initializing its existing 
directory. The directory area and file bit map blocks on the file- 
structured device are set to 0 (except for those bits in the directory 
bit map referring to the directory itself and the file bit maps) . 

In order to avoid clearing a directory when its files are still in use, 
the directory is checked for open files. If there are no open files, 
the directory is cleared; otherwise, control is transferred to the 
Monitor error handling routine to output an lOPS 10 error code (file 
still active) . 

3.1.9 .CLOSE 
FORM; .CLOSE a 

VARIABLES: a = .DAT slot number (octal radix) 

EXPANSION: LOC CAL + 

LOC +1 6 /The CAL handler will place the unit 

/if applicable) associated with 
/.DAT slot a into bits 0 through 2. 

DESCRIPTION: When action has been initiated ( . INIT or .SEEK or .ENTER) 

on a file (whether the device is file-oriented or not) this action 
must be terminated by a .CLOSE command. 

On input, it is assumed that the user is finished with the file when 
the .CLOSE macro is used, so the file is closed. On output, all 
associated output is allowed to finish and then an EOF (end-of-f ile) line 
line is output before the file is finally closed. If a refers to a 
file-oriented device, any earlier file of the same name and extension, 
as currently referenced, is deleted from its directory after the new 
file is written. 
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3.1.10 


.MTAPE 


.MTAPE a, XX 

a = .DAT slot number (octal radix) 

XX = Number of magnetic tape function or configuration: 

00 = Rewind to load point 

02 = Backspace record 

03 = Backspace file 

04 = Write end-of-file 

05 = Skip record 

06 = Skip file 

07 = Skip to logical end-of-tape 

10 = 7~channel, even parity, 200 bpi 

11 = 7-channel, even parity, 556 bpi 

12 = 7-channel, even parity, 800 bpi 

13 = 9-channel, even parity, 800 bpi 

14 = 7-channel, odd parity, 200 bpi 

15 = 7 channel, odd parity, 556 bpi 

16 = 7-channel, odd parity, 800 bpi 

17 = 9-channel, odd parity, 800 bpi 

LOG CAL + XX^ o + a- ^ _ 

b-o y— 1 / 

LOG +1 7 /The CAL handler will place the unit 

/number (if applicable) associated 
/with .DAT slot a into bits 0 
/through 2 . 

DESCRIPTION: .MTAPE is used to perform functions unique to non-file- 

oriented bulk storage devices. In general, these functions are intended 
for magnetic tape; however, two of the functions, REWIND TO LOAD POINT 
and BACKSPACE RECORD, may be used with any bulk storage device handler 
that is capable of being employed in a non-file-oriented manner. For 
example, the DECtape handler is directed to work in a file-oriented 
mode for a particular .DAT slot if it encounters a .SEEK or .ENTER 
as the next command after the .INIT command for that .DAT slot. If it 
encounters .MTAPE REWIND or BACKSPACE as the first command after .INIT, 
it sets up to work in non-file-oriented modes and interprets subsequent 
.READ and .WRITE commands appropriately. After the mode is established, 
commands in the other mode must not be executed. 


FORM: 

VARIABLES : 


EXPANSION: 


3.1.11 .READ 

FORM: .READ a, M, L, W 


VARIABLES; a = .DAT slot number (octal radix) 


M = Data mode 


r 0 = lOPS Binary 
1 = Image Binary 
) 2 = lOPS ASCII 

N 3 = Image Alphanumeric 

4 = Dump Mode 

5 = 9-channel Dump Mode 


L = Line Buffer address 


(MAGtape only) 


W = Line buffer word count (decimal radix) , including 
the two-word header 


3-8 



EXPANSION: LOG 

LOG + 1 

LOG + 2 

LOG + 3 


GAL + Mg_g + 

10 /GAL handler will place unit number 

/(if applicable) into bits 0 through 2 ) 

L 

.DEG /Decimal radix 

-W . 


DESGRIPTION: The .READ command is used to transfer the next line of data 

from the device assigned to .DAT slot a to the line buffer in the user's 
program. In the operation, M defines the mode of the data to be trans- 
ferred; L is the address of the line buffer; and W is the number of words 
in the line buffer (including the two-word header) . 


Since I/O operations and internal data transfers may proceed asynchron- 
ously with computation, a .WAIT command must be used after a .READ 
command before the user attempts to use the data in the line buffer or 
to read another line into it. 


When a .READ (non-Dump Mode) has been completed, the program should 
interrogate bits 12 and 13 of the first word of the line buffer header 
to ascertain that the line was read without error. Bits 14 through 17 
should be checked for end-of-medium and end-of-file conditions. 


3.1.12 .WRITE 


FORM: .WRITE a, M, L, W 


VARIABLES: a 


M 


L 


.DAT slot number (octal radix) 


Data mode 


0 = lOPS Binary 

1 = Image Binary 

2 = lOPS ASGII 

3 = Image Alphanumeric 

4 = Dump Mode 

5 = 9-channel Dump Mode 


Line buffer address 


(MAG tape only) 


W = Line buffer word count (decimal radix) , including the 
two-word header 


EXPANSION: LOG 

LOG + 1 

LOG + 2 

LOG + 3 


GAL + Mg_g to ^ 9 . 3^7 

11 /GAL handler will place the unit 

/number (if applicable) associated 
/with .DAT slot a into bits 0 
/through 2 . 

L 

.DEG /Decimal radix 

-W 


DESGRIPTION: .WRITE is used to transfer a line of data from the 

user's line buffer to the device associated with a .DAT slot a. 


.WAIT must be used after a .WRITE command, before the line buffer is 
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is used again, to ensure that the transfer to the device has been 
completed. 

On non-bulk storage devices, headers are output along with the data in 
lOPS binary mode only (bit 9 and 11 of header word 0 should be set to 1) . 
On bulk storage devices, headers are output along with the data in all 
modes except dump mode. In image modes, the header space cannot be used 
for data, even though the headers are not written out. The word pair 
count in the header takes precedence over maximum size (or word count) 
in all modes and must be inserted by the user. 

For both .READ and .WRITE macros, dump mode causes the transfer of the 
specified core area to or from one record on magnetic or paper tape. 

One or more blocks on DECtape or disk may be occupied by a single dump 
command. A subsequent .WRITE in dump mode will utilize the unfilled 
portion of the last block. 

3.1.13 .WAIT 

FORM : . WAIT a 

VARIABLES: a = .DAT slot number (octal radix) 

EXPANSION: LOG CAL + 

LOG +1 12 /The CAL handler will place the 

/unit number (if applicable) 
/associated with .DAT slot a into 
/bits 0 through 2 . 

DESCRIPTION: .WAIT is used to detect the availability of the user's 

line buffer (being filled by .READ or emptied by .WRITE) . If the 
line buffer is available, control is returned to the user immediately 
after the .WAIT macro expansion (LOG + 2) . If the transfer of data 
has not been completed, control is returned to the .WAIT macro. .WAIT 
must also be used after the .TRAN command. 

3.1.14 .WAITR 

FORM: .WAITR a, ADDP 

VARIABLES: a = .DAT slot number (octal radix) 

ADDR = Address to which control is passed if line buffer 
is not available for use. 

EXPANSION: LOG CAL + lOOOg + 

LOG +1 12 /The CAL handler will place the 

/unit number (if applicable) 
/associated with .DAT slot a into 
/bits 0 through 2 . 

LOG + 2 ADDR 
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DESCRIPTION: .WAITR is also used to detect the availability of the user's 

line buffer. If the buffer is available, control is returned to the user 
immediately after the .WAITR macro expansion (LOG + 3) . If the transfer 
of the data has not been completed, however, control is given to the 
instruction at ADDR. It is the user's responsibility to return to the 
.WAITR to again check the availability of the buffer. 

3.1.15 .TRAN 


FORM: 


.TRAN a, D, B, L, W, P 


VARIABLES: a 


.DAT slot number (octal radix) 


D = Transfer direction 


EXPANSION: 


0 = Input Forward 

1 = Output Forward 

2 = Input Reverse^ 

3 = Output Reverse^ 

B^= Device address; for example, block number (octal 
radix) for DECtape 

L = Core starting address 


W = Word count (decimal radix) 


P^= High order 3 bits of device address (e.g., RS15 
DECdisk platter number, 0-7) . 


LOG 


CAL + ^7*8 ^9-17 ^ ^5-7 ^8 ^ ^9-17 


LOG + 1 13 


LOG +2 B 

LOG +3 L 

.DEC 

LOG +4 -W 


/The CAL handler will place the unit 
/number (if applicable) associated 
/with .DAT slot a into bits 0 
/through 2 . 


/Decimal radix 


DESCRIPTION: .TRAN is employed when the user desires total freedom in 

data structuring of bulk storage devices. It provides the facility to 
read or record user-specified areas on the device. .TRAN should be 
followed by a .WAIT macro to ensure that the transfer has been 
completed. 


3.1.16 .TIMER 

FORM: .TIMER n, C 

VARIABLES: n = Number of clock increments (decimal radix) 

C = Address of subroutine to handle interrupt at end of 
interval 

^DECtape only. 

^Ignored for magnetic tape. 

^The argument P is omitted for devices other than the DECdisk. If the 
argument P is present, the argument D must be either 0 or 1; values of 
2 or 3 for D will produce erroneous results. 
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EXPANSION: LOG 


CAL 

LOG +1 14 

LOG +2 C 

.DEC /Decimal radix 

LOG + 3 -n 

DESCRIPTION: .TIMER is used to set the real-time clock to n increments 

ttl 

and to start it. Each clock increment represents 1/60 second for 
60-Hz systems and 1/50^ second for 50-Hz systems. 


C + 1 is the location to which control is given when the Monitor 
services the clock interrupt. The coding at C should be in subroutine 
form; for example, 

C 0 C + 1 is reached via JMS 

DAG SAVEAC 

. Must not contain any 

. Monitor CALs in I/O 

or Keyboard Systems 
LAC C /Restore Link 

RAL 

LAC SAVEAC /Restore AC 
XI T JMP*C 

so that control will return to the originally interrupted sequence when 
the interval-handling routine has been completed. The Monitor auto- 
matically reenables the interrupt system before transferring control 
to C + 1. If the user wishes to initiate another interval at the com- 
pletion of the previous interval in the subroutine specified to .TIMER, 
he may do so as follows; 

LAC (desired interval in 2 ' s complement) 

DAC* (7 

LAC C /Restore Link 

RAL 

LAC SAVEAC /Restore AC 
CLON /Turn on clock 

JMP*C 


3.1.17 .EXIT 

FORM: .EXIT 

EXPANSION: LOG CAL 

LOG +1 15 

DESCRIPTION: .EXIT provides the standard method for returning to the 

Monitor after completion of a system or user program. In the BASIC 
I/O Monitor environment, it causes a program halt; in the ADVANCED 
Monitor environment, it causes the non-resident Monitor to be reloaded. 
Whan the reloading process has been completed, the Monitor types 

KM 15 Vnn 

$ 

on the teleprinter, indicating that it is ready to accept the next 
command . 
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CHAPTER 4 


ADVANCED MONITOR 

4.1 ADVANCED MONITOR FUNCTIONS 

The ADVANCED Monitor is designed to operate with a system that has some 
form of bulk storage (see Hardware Requirements, Section 1.2). It 
includes all elements of the BASIC I/O Monitor in addition to routines 
that accept and interpret Teletype keyboard commands, change device 
assignments, and automatically load and initiate system and user programs. 

4.2 PROGRAMMING EXAMPLE 

The following example illustrates the use of system macros with 
MACRO-15 programs in the ADVANCED Monitor Environment. The example 
inputs a line of data from the teleprinter keyboard, writes it on 
DECtape, reads it back from DECtape, and outputs it on the teleprinter. 
Before subsequent keyboard inputs, the program prints the messages: 

FILE ALREADY PRESENT! I 

DO YOU WISH TO KEEP IT? (Y OR N) AND CR. 

By typing Y on the keyboard, the file is saved and a new file is 
created for the next line of input from the keyboard. By typing N on 
the keyboard, the next line of data input from the keyboard is 
written on DECtape with the same file name given to the previous line. 

The name of the file is initially ECHO TST. The file name for each 
new file (providing that the previous file was not deleted, is obtained 
by incrementing location NAME+1. This produces a series of files, 

ECHO TST, ECHOA TST, ECHOB TST, ECHOC TST,..., etc., (since the 
alphabet in .SIXBIT begins Olg/ ^^8' ®tc.). 

The arguments used by the system macros are given symbolic names by 
means of MACRO direct assignment statements at the beginning of the 
program to facilitate recall for the programmer, and to change the 
arguments readily. The partial assembly listing that follows the 
example shows how the first several system macros are expanded at 
assembly time. (The reader may wish to compare these expansions with 
the system macro descriptions in Chapter 3.) 
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Example : 


Source Listing 


.TITLE DTECHO 
DECTAPE:? 

TTI=6 

TT0=5 

IN=0 

0UT=i 

I0PS=2 

.lODEV 5,6,7 

START .INIT DECTAPE, OUT, RESTRT 

.INIT TTI, IN, RESTRT 
,INIT TTO, OUT, RESTRT 
.FSTAT DECTAP,NAME 
SZA 

JMP UPDATE 

READKB .READ TT I, 10 PS , BUFFER, 34 

.WAIT TTI 
LAC UDSW 
SZA 

JMP NEWFIL 
WRITE .ENTER DECTAP,NAME 

.’^ITE DECTAP, lOPS, BUFFER, 54 
.WAIT DECTAP 
.CLOSE DECTAP 

READDT .INIT DECTAP, IN , RESTRT 

.SEEK DECTAP, NAME 
.READ DECTAP, lOPS, BUFFER, 34 
.WAIT DECTAP 
.WRITE TTO, lOPS, BUFFER, 54 

.WAIT TTO 
RESTRT .CLOSE TTO 

.CLOSE TTI 

.CLOSE DECTAP 

JMP START 

UPDATE .WRITE TTO , 10 PS , MSGl , 34 

.WAIT TTO 

.WRITE TT0,I0PS,MSG2,34 

.WAIT TTO 

.READ TTI,I0PS, C0M,8 

.WAIT TTI 

LAC COM+2 

AND (774000 

SAD (544000 

JMP YES 

DZM UDSW 

JMP READKB 
YES CLC 

DAC UDSW 

JMP READKB 
NEWFIL ISZ NAME+1 
JMP WRITE 

MSGl MSGB-MSGI/B’t^IOOO 

0 

.ASCII ’’FILE ALREADY " 

.ASCII "PRESENT! !"<15> 

MSG2 COM-MSG2/2+1000 

0 

.ASCII "DO YOU WISH TO KEEP I 
.ASCII "(Y OR N) AND CR.”<15> 
COM .BLOCK 10 
BUFFER .BLOCK 42 
NAME .SIXBT "ECHO@@TST" 

UDSW 0 

.END START 


/INITIALIZE DECTAPE OUTPUT, 
/TELETYPE INPUT, 

/AND TELETYPE OUTPUT 
/IS FILE PRESENT? 

/NO, INPUT KEYBOARD 
/YES, OUTPUT MSGl AND MSG2 
/INPUT TOPS ASCII FROM KEYBOARD 
/WAIT UNTIL INPUT COMPLETE 
/TEST UPDATE SWITCH 
/0 REPLACE INPUT FILE 
/-IrSAVE INPUT; CREATE NEW OUTPT 
/LOCATE FREE DECTAPE FILE 
/OUTPUT DATA ON DECTAPE 
/WAIT UNTIL OUTPUT COMPLETED 
/CLOSE FILE 

/INITIALIZE DECTAPE INPUT 
/LOCATE FILE "NAME" 

/READ INTO BUFFER 
/V/AIT UNTIL READ COMPLETE 
/OUTPUT TO TELETYPE 
/WAIT UNTIL OUTPUT COMPLETE 
/TERMINATE TELETYPE OUTPUT, 
/TELETYPE INPUT, 

/AND DECTAPE INPUT/OUTPUT 
/LOOP FOR UPDATE OPTION 
/OUTPUT MSGl 
/AND MSG2 
/ON 

/TELETYPE 

/READ RESPONSE 

/WAIT UNTIL READ COMPLETE 

/GET FIRST WORD 

/SAVE FIRST SEVEN BITS 

/IS CHAR A Y? 

/YES 

/NO, SET TO REPLACE INPUT FILE 
/LOOP TO READ KEYBOARD 
/SET UPDATE SW. TO SAVE 
/INPUT, CREATE NEW OUTPUT 
/LOOP TO READ KEYBOARD 
/CHANGE FILE NAME 
/TO CREATE NEW OUTPUT 
/WPC FOR }-[EADER WORD 0 


/WPC FOR HEADER WORD 0 
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Example (continued) 
Assembly Listing 


PAGE 

1 

DTECI 

HO 

•SRC 

DTECHO 


1 








.title dtecho 

2 




000007 

A 


oectape 

S7 

3 




000006 

A 


TTIs6 






000005 

A 


TTO = 5 


5 




000000 

A 


IN = 0 


6 




000001 

A 


OUTsl 


7 




000002 

A 


I0PSS2 


8 








.lODEV 5,6,7 

9 


00000 

R 




START 

,INIT OECTAPE, OUT, REStrT 



00000 

R 

001007 

A 

•G 


CAL-^OUT*i000 DECTAPE5777 



00001 

R 

000001 

A 

*G 


1 



00002 

R 

000070 

R 

«G 


RESTrT+0 



00003 

R 

000000 

A 

«G 


0 

10 








,INIT TTI, IN, RESTRT 



00004 

R 

000006 

A 

«G 


CAL+IN<^1000 TTU777 



00005 

R 

000001 

A 



1 



00006 

R 

000070 

R 

<»G 


RESTrT*0 



00007 

R 

000000 

A 

«G 


0 

11 








,INIt TTO, OUT, RESTRT 



00010 

R 

001005 

A 

»G 


CAL+OUT*1000 TT0S777 



00011 

R 

000001 

A 

#G 


1 



00012 

R 

000070 

R 

«G 


RESTrT*0 



00013 

R 

000000 

A 

»G 


0 

12 








.rSTAT DECTAP,NAmE 



00014 

R 

003007 

A 

*G 


CAL+3000 DECTAP5777 



00015 

R 

000002 

A 

#G 


2 



00016 

R 

000246 

R 

*G 


NAME 

13 


00017 

R 

740200 

A 



SZA 

14 


00020 

R 

600077 

R 



JMP UPDATE 

15 


00021 

R 




readkb 

.read tTI , IOPS, buffer, 34 



00021 

R 

002006 

A 

«G 


CAL-^lOPSttlOCO TTIS777 



00022 

R 

000010 

A 

»G 


10 



00023 

R 

000204 

R 

»G 


BUF^'ER 







»G 


,OEC 



0 3024 

R 

777736 

A 

»G 


«34 

16 








.WAIT TTI 



00025 

R 

000006 

A 

HQ 


CAL TTU777 



00026 

R 

000012 

A 

*G 


12 

17 








.EJECT 


/INITIALIZE OECTAPE OUTPUT, 


/teletype INPUT, 


/AND TELETYPE OUTPUT 


/IS file present? 

/NO, INPUT KEYBOARD 
/YES, OUTPUT MSGl AND MSG2 
/INPUT lOPS ASCII FROM KEYBOARD 


/WAIT UNTIL INPUT COMPLETE 



PACE 

2 

DTECHO 

SRC 

DTECHO 

18 


0002 7 

R 

200251 

R 


19 


00030 

R 

740220 

A 


20 


00031 

R 

602132 

R 


21 


00032 

R 



WRITE 



00032 

R 

002007 

A 

•G 



00033 

R 

000024 

A 

«G 



0 0 0 3 4 

R 

000246 

R 

«G 

22 


02035 

R 

002007 

A 

*G 



00036 

R 

000011 

A 

«G 



0 00 3 7 

R ' 

000204 

R 

«G 







*G 



00040 

R 

777736 

A 

«G 

23 


0 00 41 

R 

000007 

A 

»G 



00042 

R 

000012 

A 

<»G 

24 


0204 3 

R 

000007 

A 




000 4 4 

R 

000006 

A 

«G 

25 


0 0 04 5 

R 



REAODT 



00045 

R 

000007 

A 




0 0046 

R 

000001 

A 

OG 



0 0 0 4 7 

R 

000070 

R 

«G 



00050 

R 

000000 

A 

»G 

26 


00251 

R 

000007 

A 

«G 



00052 

R 

000003 

A 

»G 



00053 

R 

000246 

R 

«G 

27 


0 00 54 

R 

002007 

A 

<»G 



0 0 055 

R 

000010 

A 

«G 



0 0256 

R 

000204 

R 

«G 







«G 



00057 

R 

777736 

A 

*G 

26 


00060 

R 

000007 

A 

^G 



00061 

R 

000012 

A 

«G 


29 


LAC UDSW 

SZA 

JMP MEWFIL 

.enter nECTAP»NAME 
CAl DECTAP5777 
4 

NAME 

,^R1TE OECTAPi 10pS,BUFFeR|34 
CAL+ IOPS*1000 DECTAPS777 

11 

BUFf- ER 

,f)£C 

-34 

,;^AIT hECTAP 
CAL DECTAPS777 
12 

.CLOSE DECTAP 
CAL DECTAPS777 
6 

,INIT OECTAP, IN,RESTRt 
CAL+IN«1000 DECTAPS777 
1 

re;strt*0 

0 

.SEEK DECTaPiNAME 
CAL DECTAPS777 
3 

NAME 

,RE«D DECTAPi lOpS, buffer, 34 
CAL* IOPS«1000 DECTAP5777 
10 

BUFI- ER 

.DEC 

-34 

,AAn DECTAP 
CAL L'ECTaPS777 
12 

.EJECT 


/TEST UPDATE SWITCH 
/0 REPLACE INPUT FILE 
/-IsSAVE INPUT; CREATE NEW OUTpT 
/LOCATE FREE DECTAPE FILE 

/OUTPUT DATA ON DECTAPE 

/WAIT until output COMPLETED 
/CLOSE file 

/INITIALIZE DECTAPE INPUT 

/LOCATE FILE "NAME” 

/read INTO buffer 

/WAIT UNTIL READ COMPLETE 
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DTECHO SRC 


OTECHO 


30 



00062 

R 

002005 

A 

«G 


00063 

R 

000011 

A 

»G 


00064 

R 

000204 

R 

• G 








00065 

R 

777736 

A 

*G 

31 

00066 

R 

000005 

A 

«G 


00067 

R 

000012 

A 

<»G 

32 

000 7 0 
00070 

R 

R 

000005 

A 

“G 


00071 

R 

000006 

A 

»G 

33 

00072 

R 

000006 

A 

«G 


000 7 3 

R 

000006 

A 

*G 

34 

0 00 7 4 

R 

000007 

A 

*G 


00075 

R 

000006 

A 

*G 

35 

00076 

R 

600000 

R 


36 

00077 

R 





00077 

R 

002005 

A 

*G 


00103 

R 

000011 

A 

«G 


00101 

R 

000134 

R 

«G 






«G 


00102 

R 

777736 

A 

4>G 

37 

00103 

R 

000005 

A 

«G 


0010 4 

R 

000012 

A 

«G 


38 


♦write TTO, I0PS»BUFFER,34 
CAL+IOPS*1000 TT0S777 
11 

BUFP ER 

.DEC 

-34 

.WAIT TTO 
CAL TTOS777 
12 

.CLOSE tTO 
CAL TT05777 
6 

.CLOSE TTI 
CAL TTI5777 

6 

.CLOSE DECTAP 
CAL DECTAPS777 
6 

JHP start 

.write TTO, I0PSfKSGl,34 
CAL+lOPSttl000 TT05777 
11 

MSGl 

.DEC 

-34 

,WAIt TTO 
cal TT0&777 
12 

.EJECT 


/OUTPUT TO teletype 

/WAIT UNTIL OUTPUT COMPLETE 
/terminate teletype OUTPUTi 

/teletype input, 

/AND DECTAPE INPUT/OUTPUT 

/LOOP FOR UPDATE OPTION 
/OUTPUT MSGl 

/and MSG2 
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CTECMO SRC DTECHG 


39 

00105 

R 

002005 

A 



, write tTO, I0PS#mSG2,34 
CAL+IOPS#1000 TT0&777 

/ON 


00106 

R 

000011 

A 

«G 


11 



00107 

R 

000150 

R 

«G 


KSG2 







*G 


.DEC 



00110 

R 

777736 

A 

*G 


^34 


40 

0 0111 

R 

000005 

A 

«G 


.wait tto 

CAL TTOS777 

/teletype 


00112 

R 

000012 

A 

»G 


12 


41 

00113 

R 

002006 

A 

«G 


.read TTI , I0PS»CDM,8 
CAL-^lOPSttl000 TTI«777 

/READ RESPONSE 


00114 

R 

000010 

A 

«G 


10 



00115 

R 

000174 

R 

«G 


COM 









.DEC 



00116 

R, 

777770 

A 



-8 


42 

00117 

R 

000006 

A 

«G 


.WAIT TTI 

CAL TTIS777 

/WAIT UNTIL READ COMPLETE 


00120 

R 

000012 

A 

«G 


12 


43 

00121 

R 

200176 

R 



LAC COM+2 

/GET FIRST WORD 

44 

00122 

R 

500252 

R 



AND (774000 

/SAVE FIRST SEVEN BITS 

45 

00123 

R 

540253 

R 



SAD (544000 

/IS CHAR A Y7 

46 

00124 

R 

600127 

R 



JMP yes 


47 

00125 

R 

140251 

R 



DjfM UOSW 

/NO, SET TO REPLACE INPUT 

48 

00125 

R 

600021 

R 



JMP rEADKB 

/LOOP TO READ KEYBOARD 

49 

00127 

R 

750001 

A 


yes 

CLC 

/SET UPDATE SW, TO SAVE 

50 

00130 

R 

040251 

R 



DAC UDSW 

/INPUT, CREATE NEW OUTPUT 


00131 

R 

600021 

R 



JMP rEADKB 

/LOOP TO READ KEYBOARD 

52 

00132 

R 

440247 

R 


NF-WF IL 

ISZ NAME+1 

/CHANGE FILE NAME 

53 

00133 

R 

600032 

R 



JMP WRITE 

/TO CREATE NEW OUTPUT 

54 

00134 

■R 

006000 

A 


MSGl 

MSG2!-MSGi/2#1000 

/WPC FOR HEADER WORD 0 

55 

00135 

R 

000000 

A 



0 

56 

00136 

R 

432231 

A 



.ASCII *»fILE already »» 



00137 

R 

442500 

A 






0 0140 

R 

406312 

A 






00141 

R 

242602 

A 






.00142 

R 

422624 

A 






00143 

R 

000000 

A 





57 

00144 

R 

502450 

A 



.ASCII ’'pRESENTI !’'<15> 



00145 

R 

551612 

A 






00146 

R 

472504 

A 






00147 

R 

120432 

A 






58 


.EJ£CT 
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DTECHO SRC 


dtecho 


59 

0015(/. 

R 

012000 

A 

MSG2 

60 

00151 

R 

000000 

A 


61 

00152 

R 

422364 

A 



00153 

R 

054636 

A 



00154 

R 

525012 

A 



00155 

R 

744646 

A 



00156 

R 

441012 

A 



00157 

R 

447500 

A 



00160 

R 

456130 

A 



00161 

R 

550100 

A 



00162 

R 

446504 

A 



00163 

R 

037400 

A 


62 

00164 

R 

242624 

A 



00165 

R 

047644 

A 



00166 

R 

202345 

A 



00167 

R 

120202 

A 



00170 

R 

472104 

A 



00171 

R 

041644 

A 



00172 

R 

270320 

A 



00173 

R 

000000 

A 


63 

00174 

R 


A 

COM 

64 

00204 

R 


A 

buffer 

65 

002^6 

R 

050310 

A 

NAME 


00247 

R 

170000 

A 



0 0 2 5 

R 

242324 

A 


66 

00251, 

R 

000800 

A 

UDSW 

67 



000000 

R 



00252 

R 

774000 

A 



8 0 253 

B 

544000 

A 

*L 


s 

IZE 

:=00254 


NO ERROR 


page 

6 

DTECHO 

SRC 

dtech 

w 

BUFFER 

00204 

R 

COM 

00174 

R 

lOPS 

080002 

A 

MSGl 

00134 

R 

NEWFIL 

00132 

R 

OUT 

000001 

A 

restrt 

80078 

R 

START 

00000 

R 

UDSW 

80251 

R 

UPDATE 

00077 

R 


COM-hSG2/2»1000 /WPC FOR HEADER WORD 0 

0 

.ASCII »00 YOU WISH TO KEEP IT 7 » 


.ASCII »(Y OR N) AND CR.«<15> 


.SLOCK 10 
.BLOCK 42 
.SIXBT »ECH06»e»TST” 


0 

.END START 


LINES 


DECTAP 000PI07 A IN 000000 A 
HSG2 00150 R name 00246 R 
REAODT 00045 R READKB 00021 R 
TTI 000006 A TTO 000005 A 
WRITE 00032 R YES 00127 R 
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DTECHO SRC 


DTECHO 


IN 

00000H 

A 

START 

00000 

R 

OUT 

000001 

A 

TTO 

000005 

A 

TTI 

000006 

A 

oectap 

000007 

A 

WRITE 

0003? 

R 

READDT 

00045 

R 

restrt 

00070 

R 

YES 

00127 

R 

NEWF IL 

00132 

R 

MSGl 

00134 

R 

COM 

00174 

R 

BUFFER 

00204 

R 

NAME 

00246 

R 


page 8 DTECHO CROSS REFERENCE 


buffer 

00204 

15 

22 

27 

30 

64* 



COM 

00174 

41 

43 

59 

63* 




DECTAP 

000007 

2* 

9 

12 

21 

22 

23 

24 



27 

28 

34 





IN 

000000 

5« 

10 

25 





lOPS 

000002 

7» 

15 

22 

27 

30 

36 

39 

MSGl 

00134 

36 

5 4 « 

54 





MSG2 

00150 

39 

54 

59ft 

59 




NAME 

00246 

12 

21 

26 

52 

65ft 



newfil 

00132 

20 

52« 






OUT 

000001 

6» 

9 

11 





READDT 

00045 

25« 







READKB 

00021 

15« 

48 

51 





RESTRT 

00070 

9 

10 

11 

25 

32 ft 



start 

00000 

9« 

35 

67 





TTI 

000006 

3« 

10 

15 

16 

33 

41 

42 

TTO 

000005 

4* 

11 

30 

31 

32 

36 

37 

UDSW 

00251 

18 

47 

50 

6 6ft 




update 

00077 

14 

36<» 






WRITE 

00032 

21« 

53 






YES 

00127 

46 

49* 







lOPS 000002 A 
rEAOKB 00021 R 
UPDATE 00077 R 
mSG2 00150 R 
UDSW 00251 R 


25 26 


41 


39 


40 



4 . 3 KEYBOARD COMMANDS 


The ADVANCED Monitor provides : 


a. The ability to request system information and 
directions for system operation. 

b. I/O device independence, through the ability 
to dynamically change I/O device assignments 
before loading a program. 

c. The ability to call, load, and execute system 
and user programs via simple keyboard commands 


When the ADVANCED Monitor initially gets control it outputs : 


KM 15 Vnn 

$ 


to the teleprinter to indicate readiness to accept a keyboard command. 
Subsequently, it outputs only the dollar sign ($) to indicate readi- 
ness. In both cases, the keyboard command should be typed on the 
same line as the dollar sign ($) . 

ADVANCED Monitor commands fall into three categories: 


a. Commands that load system programs (terminated with 
a carriage return (^ ) or ALT MODE) . 

b. Commands to perform special functions. 

c. Control character commands, formed by holding 
down the CTRL key while striking a letter key. 

These commands are used during the running of 
system or user programs. (System programs echo 
control character commands by typing an up 
arrow ( i ) followed by the associated character.) 


4.3.1 System Program Load Commands 

Loading commands instruct the ADVANCED Monitor to bring in the System 
Loader, which is used to load all system programs from the system 
device. The commands which follow are available to the user for 
loading systems programs via the Monitor. 
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Command 


F4 
F4I 
lyiACRO 
MACRO I 
PIP 
EDIT 
EDITVP 
LOAD 
GLOAD 
DDT 
DDTNS 
UPDATE 
DUMP 

PATCH 
CHAIN 

EXECUTE (E) 

SGEN 
SRCCOM 
DTCOPY 

All commands should be terminated by a Carriage RETURN ) or ALT MODE. 
When the requested program has been loaded and is waiting for keyboard 
input, an indication is given on the teleprinter with an appropriate 
message, such as 

LOADER Vnn 
> 

or F4 Vnn 

> 

or EDITOR Vnn 

> 

etc. where: Vnn = current version of the 

program 

4.3.2 Special Function Commands 

The special function keyboard commands available in the ADVANCED 
Monitor environment are described in the following paragraphs. 

4. 3.2.1 LOG (or L) - The LOG command is used to make hard copy records 
of user comments on the teleprinter. When the LOG command is encountered, 
the Monitor ignores all typing up to and including the next ALT MODE. 

Example: 

$LOG THIS IS AN EXAMPLE. (ALT MODE) 


System Program Loaded 
FORTRAN IV Compiler 

8K FORTRAN IV Compiler (DECtape I/O only) 
MACRO-15 Assembler 

8K MACRO-15 Assembler (DECtape only) 

Peripheral Interchange Program 

Symbolic Text Editor 

Symbolic Text Editor (VP15A Displciy) 

Linking Loader 

Linking Loader (set to load and go) 

Dynamic Debugging Technique program 

DDT program with no user symbol table 

Library File Update program 

Program to dump saved area (see CTRL Q 
and QDUMP commands) 

System tape Patch program 

Program to create a system of core overlays 

Control program to supervise core residency 
during execution of CHAIN built overlay system 

System Generator program 

Text Line Comparison program. 

8K high speed DECtape copy program 
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4. 3. 2. 2 SCOM Cor S) - The SCOM command causes typeout of system con- 
figuration information, including available device handlers, the. skip 
chain order, and manual restart and dump procedures. 


Example : 


KM15 V5A 
$SC0M 

SYSTEM INFO - V5A - 7/1/70 

17646 - BOOTSTRAP RESTART ADDR 

17636 - 1ST FREE CELL BELOW BOOTSTRAP 

1745 - 1ST FREE CELL ABOVE RESIDENT MONITOR 

141 - ADDR OF .DAT 

565 - tQ ADDRESS FOR MANUAL DUMP 

101 - START BLOCK FOR tQ DUMP AREA 

255 - KM15 START WITH RESTART ADDRESS IN CELL 0 

SYSTEM HAS EAE 

7 CHANNEL MAGTAPE ASSUMED BY HANDLERS 
I/O HANDLERS AVAILABLE: 

TTA TELETYPE: I/O, ASCII MODES, ALL FUNCTIONS 
PRA TAPE READER: INPUT, ALL MODES, ALL FUNCTIONS 
PRB TAPE READER: INPUT, lOPS ASCII MODE, ALL FUNCTIONS 
PPA PUNCH: OUTPUT, ALL MODES, ALL FUNCTIONS 
PPB PUNCH; OUTPUT, ALL MODES LESS lOPS ASCII, ALL FUNCTIONS 
PPC PUNCH: OUTPUT, lOPS BINARY MODE, ALL FUNCTIONS 
DTA DECTAPE: 3 FILES, I/O, ALL MODES, ALL FUNCTIONS 
DTB DECTAPE: 2 FILES, I/O, lOPS MODES, LIM FUNCTIONS 
DTC DECTAPE: 1 FILE, INPUT, lOPS MODES, LIMITED FUNCTIONS 
DTD DECTAPE: 1 FILE, I/O, ALL MODES, ALL FUNCTIONS 

DTE DECTAPE: 1 FILE, I/O, ALL MODES, ALL FUNCTIONS EXCEPT .MTAPE 

DTF DECTAPE; NON-FILE ORIENTED FOR F4 .OTS 
DKA DECDISK; 3 FILES, I/O, ALL MODES, ALL FUNCTIONS 
DKB DECDISK: 2 FILES, I/O, lOPS MODES, LIM FUNCTIONS 
DKC DECDISK: 1 FILE, INPUT, lOPS MODES, LIM FUNCTIONS 
DKD DECDISK: 1 FILE, I/O, ALL MODES, ALL FUNCTIONS 

DKE DECDISK: 1 FILE, I/O, ALL MODES, ALL FUNCTIONS EXCEPT .MTAPE 

DKF DECDISK: NON-FILE ORIENTED FOR F4 .OTS 
MTA MAGTAPE: 3 FILES, I/O, ALL MODES, ALL FUNCTIONS 
MTC MAGTAPE: 1 FILE, INPUT, lOPS MODES, ALL FUNCTIONS 
MTF MAGTAPE; NON-FILE ORIENTED FOR F4 .OTS 
LPA LINE PRINTER: OUTPUT, lOPS ASCII MODE, ALL FUNCTIONS 
CDB CARD READER: INPUT, lOPS ASCII MODE, ALL FUNCTIONS 
VPA VP DISPLAY: OUTPUT, ASCII AND DUMP MODES, ALL FUNCTIONS 
SKIP CHAIN ORDER 
SPFAL 
DTDF 
DSSF 
MTSF 
SDDF 
RCSF 
RCSD 
LSDF 
CLSF 
RSF 
PSF 
KSF 
TSF 
DTEF 
MPSNE 
MPSK 
SPE 
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4. 3. 2. 3 API ON/OFF - This command controls the status of the Automatic 

Priority Interrupt if available in the system. API ON enables the API; 

API OFF disables the API. 

Example ; 

$API OFF 

4. 3. 2. 4 QDUMP ( or - In the event of an unrecoverable error, this 

command conditions the Monitor to dump memory on the "save, or CTRL Q, 
area" of one of the units of the system device. 

QDUMP forces automatic execution of the CTRL Q command (described in 
Paragraph 4 . 3 . 3) on all non-recoverable error calls to the Monitor Error 
Diagnostic (MED) program. It must be issued prior to the LOAD, GLOAD, 
DDT, or DDTNS command used to load the user program. (QDUMP issued 

prior to a GET has no effect after the GET, since the Monitor at CTRL Q 

time overlays the Monitor primed by QDUMP.) Note that the WRITE ENABLE 
switches on the system device should be enabled in case of error; 
otherwise, an lOPS 4 (not ready) error will follow the initial error. 

4. 3. 2. 5 HALT (or H) ^ - This command conditions the Monitor to print 

an error message and halt, in the event of an unrecoverable lOPS error . 
Depressing the CONTINUE button reloads the Monitor. HALT must be issued 
prior to the LOAD, GLOAD, DDT, or DDTNS command. (HALT issued prior to 
a GET has no effect after the GET, since the Monitor at CTRL Q time over- 
lays the Monitor primed by the HALT command.) 

4. 3.2.6 INSTRUCT (or I) - The INSTRUCT command can be used in two ways; 
INSTRUCT alone causes a summary of Monitor commands to be printed on 
the teleprinter; INSTRUCT ERRORS causes a summary of system error 
messages to be printed. 

Example : 

$I 

Kf1l5 COMMANDS: 

LOG(L): USER COMMENTS TERMINATED BY ALTMODE 
SCOM(S): SYSTEM INFO 
INSTRUCT(I): LIST OF MONITOR COMMANDS 
INSTRUCTCI) ERRORS: DESCRIPTION OF ERROR CODES 
REQUESTCR), REQIJESTCR) PRGNAM: .DAT SLOT USAGE 
REQUEST(R) USER: POSITIVE .DAT SLOT USAGE 
ASSIGN(A) DEVN A, B, . . . /ETC. : .DAT SLOT MODS 

DIRECT(D), DIRECT(D) M: DIRECTORY OF UNIT 0 OR M OF SYSTEM DEVICE 
NEWDIRCN) M: CLEAR DIRECTORY OF UNIT M OF SYSTEM DEVICE 
QDUMPCQ): SET TO SAVE CORE <tQ) ON .lOPS ERROR 


^The QDUMP and HALT commands are mutually exclusive and have no effect 
if a DDT load. 
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INSTRUCT (continued) 


HALTCH): SET TO HALT ON .lOPS ERROR 
tQN: SAVE CORE ON UNIT N 

GETCG) N; RESTORE CORE FROM UNIT N AND RESTART 
GET(G) N Xj RESTORE CORE FROM UNIT N AND START AT X 
GET(G) N HALTCH) !REST0RE CORE FROM UNIT N AND HALT 
API ON/OFF; CHANGE STATE OF API 

CHANNEL 7/9: SETUP DEFAULT ASSUMPTION FOR MAGTAPE 
tC; RESTORE KM15 
tP: USER RESTART 

KM15 PROG LOADING COMMANDS AND PROGNAM FOR REQUEST COMMAND 
LOAD: LINK LOAD AND WAIT FOR tS 
GLOAD: LINK LOAD AND GO 

DDT: LINK LOAD WITH SYMBOLS AND GO TO DDT 
DDTN3: LINK LOAD W/O SYMBOLS AND GO TO DDT 
MACRO: SYMBOLIC MACRO ASSEMBLER 
MACROI: 8K DECTAPE I/O MACRO ASSEMBLER 
F4: FORTRAN IV COMPILER 
F4I: 8K DECTAPE I/O FORTRAN IV COMPILER 
EDIT: TEXT EDITOR 
PIP: PERIPHERAL INTERCHANGE PROG 
SGEN: SYSTEM GENERATOR 
DUMP: BULK STOR DEV DUMP 
UPDATE: LIBR FILE UPDATE 
SRCCOM: SOURCE COMPARE 
EDITVP: SCOPE EDITOR 
PATCH: SYSTEM TAPE PATCH ROUTINE 
EXECUTECE) FILE: LOAD AND RUN FILE XCT 
CHAIN: XCT CHAIN BUILDER 
KM15: BATCH 

BATCHCB) DV: ENTER BATCH MODE WITH DV AS BATCH DEV 
DV: PR = PAPER TAPE READER 
CD = CARD READER 

$JOB: CONTROL COMMAND WHICH SEPARATES JOBS 

$DATA: BEGINNING OF DATA 

SEND: END OF DATA 

SEXIT: LEAVE BATCH MODE 

tT: SKIP TO NEXT JOB 

tC: LEAVE BATCH MODE 


4. 3. 2. 7 REQUEST (or R) - The REQUEST command allows examination of the 
.DAT slots associated with various programs^. The command takes the 
following form: 


REQUEST XXXXXX 

where XXXXXX is the system program name (that is, the system program 
load command), or USER for all positive .DAT slots, or blank for an 
entire .DAT table printout. 


iSee Paragraph 5.3 for .DAT slots used by system programs, their uses, 
and acceptable I/O handlers. 
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Examples : 


SREQUEST 


• DAT 

DEVICE 

USE 

-15 

DTA2 

OUTPUT 

-14 

DTAl 

INPUT 

-13 

PPC0 

OUTPUT FOR MACRO, F4 

-12 

TTA0 

LISTING 

-11 

PRB0 

INPUT FOR MACRO, F4 

-10 

TTA0 

INPUT 

-7 

DTC0 

SYS DEV FOR .SYSLD 

-6 

DT32 

OUTPUT FOR CHAIN 

-5 

NONE 

USER LIBR FOR .LOAD 

-4 

DTC2 

SYS INPUT 

-3 

TTA0 

TTY OUT 

« o 

TTA0 

TTY IN 

-1 

DTC0 

SYS DEV FOR .LOAD 

1 

DTA0 

USER 

2 

DTAl 

USER 

3 

DTA2 

USER 

4 

TTA0 

USER 

5 

PRA0 

USER 

6 

PPA0 

USER 

7 

DTAl 

USER 

10 

DTA2 

USER 

SREQUEST 

■ MACRO 


.DAT 

DEVICE 

USE 

-14 

DTAl 

INPUT 

-13 

PPC0 

OUTPUT 

-12 

TTA0 

LISTING 

-11 

PRB0 

INPUT 

-10 

TTA0 

SECONDARY INPUT 

-3 

TTA0 

CONTROL AND ERROR MES 

-2 

TTA0 

COMMAND STRING 


4.3.2. 8 ASSIGN (or A) - The ASSIGN command allows temporary reassign- 
ment of .DAT slots to devices other than those set at system generation 
(SGEN program) . The change of assignment is only effective for the 
current job, since the permanent assignments are restored when control 
is returned to the Monitor. The command takes the following form: 


ASSIGN DEVn a, b, etc. /DEV. x, y, etc. 

where DEV is the device handler name (the list of legal handlers for 
a particular system may be requested via the SCOM command^) . If the 

^See Paragraph 5.3 for .DAT slots used by system programs, their uses, 
and acceptable I/O handlers. Many of the devices, DECtape for example, 
have more than one I/O handler associated with them. It is imperative 
that only one version of a device handler be present during a particular 
run since confusion occurs because of the lack of communication between 
the two interrupt handlers . 
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third letter of a handler name is omitted, the letter A is assumed. 

n, m are unit numbers (if non specified, 0 is assumed) 
a, b, X, y, etc., are .DAT slot numbers 


Examples : 


$ASSIGN DTAO -10, -6/PRA -5 

(An equivalent command would be $ASSIGN DT -10, -6/PR -5) 
$ASSIGN PPB -6/DTB2 3/DTB3 5 
$ASSIGN DTAl 6, 7, 10 


DEVn can be replaced by NON to clear .DAT slots. 

$ASSIGN NON 4, 5, 10 

.DAT slots -2 and -3 are permanent and can not be modified. 

.DAT slot -7 is automatically modified only at system 
generation time to the smallest system device handler. 

4. 3.2.9 DIRECT (or D) - The DIRECT command allows printout of the 
directory associated with any unit of the system device (that is, 

0 through 7, on DECtape or DECdisk) . 

The command takes the following form; 

DIRECT N 

where N is the unit number (unit 0 is the default assumption) . 
Example : 


KM15 V5A 
SDIRECT 

DIRECTORY LISTING 


.LOAD 

BIN 

36 

DDT 

BIN 

37 

EXECUT 

BIN 

40 

INTEAE 

BIN 

41 

INTNON 

BIN 

47 

RELEAE 

BIN 

54 

RELNON 

BIN 

104 

.LIBR 

BIN 

105 

FOCAL 

BIN 

122 

8TRAN 

BIN 

244 
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FNEW 

SRC 

300 

time 

BIN 

333 

TIME10 

BIN 

340 

FOCAL 

XCT 

345 

FOCAL 

XCU 

352 

KMl‘5 

SYS 

0 

SKPBLK 

SYS 

42 

lOBLK 

SYS 

46 

SGNBLK 

SYS 

52 

SYSHAN 

SYS 

56 

SYSBLK 

SYS 

61 

.SYSLD 

SYS 

62 

BITMAP 

SYS 

71 

DIRECT 

SYS 

100 

F4I 

SYS 

141 

MACROI 

SYS 

201 

EDIT 

SYS 

627 

EDITVP 

SYS 

641 

PIP 

SYS 

656 

MACRO 

SYS 

676 

CHAIN 

SYS 

734 

F4 

SYS 

754 

DUMP 

SYS 

1007 

DTCOPY 

SYS 

1013 

PATCH 

SYS 

1016 

UPDATE 

SYS 

1025 

SRCCOM 

SYS 

1035 

SGEN 

SYS 

1047 

114 FREE BLOCKS 


4.3.2.10 NEWDIR (or N)n - This command refreshes the directory on the 
specified unit (n) of the system device control (unit 0 illegal) . 

4.3.2.11 GET (or G) - This command has three forms as follows: GET n, 
GET n xxxxx, or GET n HALT. The letter n is the number (0 through 7) 
of a unit of the system device which contains the CTRL Q area to be 
retrieved, and xxxxx is a program starting address. 

GET retrieves the core image (including the Monitor) stored on unit n 
of the system device by CTRL Q commands and restores it to memory. 
Control is transferred to address xxxxx, if specified. If HALT was 
specified, the computer halts to permit the starting address to be 
placed in the ADDRESS switches. Execution is initiated by pressing 
the START button (PIC and API are enabled) . If neither xxxxx nor 
HALT is specified, the core image is restored in memory and the 
Resident Monitor waits in a teleprinter loop with API and/or PI on for 
one of the following commands to be typed: 
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CTRL P (restart any system program and user programs 

which have issued an .INIT to the teleprinter 
with a restart address.) 

or CTRL T (restarts DDT) 

or CTRL S (starts a relocatable user program - used only 

if CTRL Q had been executed at the completion 

of a link load when the loader was waiting for 

CTRL S to be typed.) 

4.3.2.12 CHANNEL (or C) 7/9 - This command causes the default operation 
bit (.SCOM + 4, bit 6) to be cleared or set. If this bit is 0, then 
7 channel operation is assumed by the MAGtape handler. If it is 1, then 
9 channel is assumed. This default condition can also be set at system 
generation time by answering yes or no to the question 

"7 CHANNEL MAGTAPE?" 

4.3.3 Control Character Commands 

All of the ADVANCED Monitor control character commands (except 
RUBOUT) are formed by holding down the CTRL key while striking 
the appropriate letter key. The commands, the character (s) echoed 
on the teleprinter, and the resulting actions are summarized in 
Table 4-1. 

4.4 OPERATING THE ADVANCED MONITOR SYSTEM 

Detailed operating procedures for utilizing the system programs in the 
ADVANCED Monitor environment are given in the PDP-15/20 Users Guide 
(DEC-15-MG2B-D) . The following paragraphs present general descriptions 
of the operations involved in loading the ADVANCED Monitor, system 
generating, assigning devices, loading programs, and error detecting 
and handling. 

The ADVANCED Software System is supplied to all users in the form of 
a DECtape reel. Special DECtape-to-Disk and Magnetic Tape-to-Disk 
utility routines are provided to users who purchase optional disk 
storage units and use disk as the system device. 

4.4.1 Loading the ADVANCED Monitor 

Each installation employing the DECtape or DECdisk version of the 
ADVANCED Monitor must reserve unit 0 as the system device. The 
ADVANCED Monitor, the Input/Output Programming System, and all system 
and library programs needed by the user will reside on this unit. 

A System Bootstrap is supplied on paper tape in hardware READIN format. 
By setting the starting load address of the bootstrap (17637 of the 
highest memory bank available) on the console address switches. 
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TaBie 4-1 

Control Character Commands 


Command 

Echo 

Action 

CTRL S 

f s 

Starts user program after Linking Loader has brought 
it into core via a LOAD command. 

CTRL C 

iC 

Forces control back to Monitor, which types 

KM15 Vnn 
$ 

to indicate that it is awaiting a keyboard command. 
All conditions revert to the standard. 

CTRL T 

fT 

CTRL T is applicable only when using DDT or when 
operating in the BATCH mode. If DDT is being used, 
CTRL T forces control back to DDT which types 

DDT 

> 

to indicate its readiness for another DDT command. 

All previous DDT conditions remain intact (for 
example, breakpoints, register modifications, etc.). 
When operating in BATCH mode, CTRL T causes a skip 
to the next job. 

CTRL R 

iR 

Allows the user to continue when an lOPS 4 (device 
not ready) error occurs. The user must first ready 
the device, and then type CTRL R. 

CTRL P 

iP 

Forces control to address specified in the last 
.INIT command referencing teleprinter. Used 
by system programs to reinitialize or restart. 

CTRL Q n 

fQ 

Dumps the current job, in core image, onto 
prespecified blocks of unit n on the system device 
control (the WRITE ENABLE switch on this unit must 
be enabled). For example, when the system device 
is DECtape unit 0, CTRL Q requests can be made to 
DECtape only. The core image may be retrieved and 
reloaded by the GET command or examined by using 
the DUMP command to load the system Dump program. 

CTRL Q is honored whenever typed. 

CTRL U 

(a 

Cancels current line on teleprinter (input or 
output) . 

RUBOUT 

\ 

Cancels last character input from teleprinter (not 
applicable with DDT) . 
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depressing STOP and RESET, and then the READIN switch, the bootstrap is 
loaded into upper core. It clears all flags, disables the Program 
Interrupt (and the Automatic Priority Interrupt, if available) , loads the 
Monitor from the system device into lower core, and transfers control to 
it. The Monitor types 

KM15 Vnn 

$ 

when it is ready to accept commands from the user. 

The System Bootstrap may be restarted (without reloading the paper 
tape) if it has not been destroyed, by setting the ADDRESS switches 
to 17646 of the highest memory bank, depressing STOP and RESET, and 
then START. 

4.4.2 System Generation 

The System Generator (SGEN) is a standard system program used to 
create new system software configurations, either on DECtape or DECdisk. 
Upon receiving a PDP-15/20 system, the user should immediately create 
a standard system for his installation. This is done by loading the 
System Bootstrap, which loads the Monitor into core from the DECtape 
supplied with the system, and then calling the System Generator via 
the teleprinter. SGEN will create a new system on the device 
associated with .DAT slot -15. The ASSIGN command must be used prior 
to calling SGEN to assign a bulk storage device to .DAT slot -15 and 
the old system device to .DAT slot -15 as follows: 

$ASSIGN DTAO -14DTA2 -15 (or DKD2^-15)^ 

$SGEN^ 

Once loaded, SGEN communicates with the user in a conversational mode 
via the teleprinter to obtain information needed to create a system 
tape. Among the items of information it needs to know are: 

a. The device on which the system tape will operate, so that: 

1. The system device slots in the device assignment 
table (.DAT) can be set. 

2. The PIC skip chain and API channels can be set up 
for the system device. 


^It is imperative that the "D" version disk handler be used when gen- 
erating from DECtape to Disk to avoid core overflow. Conversely, 
generating from Disk to DECtape requires: 

$ASSIGN DKAO -15/DTD2 -15^ 
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b. All device skips present in the PIC skip chain and their 
order. Non-basic devices can be added to the skip chain 
at this time by supplying the device mnemonic and the 
skip lOT (s) . 

c. Total core capacity (8, 12, 16, 20, 24, 28, or 32K) 
of the installation. 

d. Special options present at the installation (API, EAE , etc.) 

e. The structure of .DAT. All system slots (-1 through -15) 
and slots 1 through 10 should be assigned. 


When .SGEN has received all of the information necessary, it creates 
a new system tape, then returns control to the Monitor. New system tapes 
can be created whenever a significant change in the installation con- 
figuration occurs. A good example of a complete system generation session 
is given in the PDP-15 Utility Programs Manual. 


The following paragraphs are intended to assist Monitor users in their 
initial efforts at "tailor-making" a system for their installation. 

The first and foremost rule before system generation is attempted in- 
volves obtaining a .SCOM printout ($S^ to the Monitor) and a .DAT 
slot printout ($R ^ to the Monitor) in order to assist in determining 
two basic elements in the system: (1) skip chain content and order, 
and (2) .DAT slot assignments. 

4. 4. 2.1 DECtape or DECdisk Systems - All users having either 
DECtape or DECdisk receive the ADVANCED Monitor system as an 8K, EAE, 
non-API, KSR-35 DECtape system. Each user having a core configuration 
greater than 8K, the API option, DECdisk, or a KSR-33 teleprinter, 
should perform a system generation in order to tailor his software 
system for maximum efficient use. Also users who, upon examining the 
.SCOM printout, discover devices or options listed that are not present 
in their system may wish to eliminate the irrelevant skips from the skip 
chain. Those with non-standard devices (A/D converter, for example) 
must expand the skip chain. The standard 8K DECtape skip chain is as 
follows : 


SPFAL 

Power Fail 

DTDF 

DECtape Done 

DSSF 

DECdisk Done 

MTSF 

Magnetic Tape Done or Error 

SDDF 

VP15A Display Done 

RCSF 

Card Column Ready 

RCSD 

Card Done 

LPSF 

Line Printer Done or Error 

CLSF 

Clock Done 

RSF 

Reader Done 

PSF 

Punch Done 

KSF 

Keyboard Done 

TSF 

Teleprinter Done 

DTEF 

DECtape Error 

MPSNE 

Non-Existent Memory Reference 

MPSK 

Memory Protect Violation 

SPE 

Memory Parity Error 


4-20 



It is important that the above order remain intact even if deletions 
or additions are to be made. For example, given a system without the 
Power Fail, Parity VP-15A Displays, or Memory Protect options, and 
without card reader, line printer, or magnetic tape, the skip chain 
should be generated as follows: 


DTDF 

DSSF 

CLSF 

RSF 

PSF 

KSF 

TSF 

DTEF 


The position of a skip to be added to the chain varies with the nature 
of the device. For example, high data rate devices might best be placed 
at the top of the chain. 


Listed below are the .DAT slot assignments as they appear in the standard 
8K DECtape system: 


DAT 

DEVICE 

USE 

-15 

DTA2 

OUTPUT 

-14 

DTAl 

INPUT 

-13 

PPCO 

OUTPUT 

-12 

TTAO 

LISTING 

-11 

PRBO 

INPUT 

-10 

TTAO 

INPUT 

-7 

DTCO 

SYSTEM DEVICE FOR . SYSLD 

-6 

DTB2 

OUTPUT 

-5 

NONE 

EXTERNAL LIBRARY FOR .LOAD 

-4 

DTC2 

SYSTEM INPUT 

-3 

TTAO 

TELEPRINTER OUTPUT 

-2 

TTAO 

KEYBOARD INPUT 

-1 

DTCO 

SYSTEM DEVICE FOR .LOAD 

1 

DTAO 

USER 

2 

DTAl 

USER 

3 

DTA2 

USER 

4 

TTAO 

USER 

5 

PRAO 

USER 

6 

PPAO 

USER 

7 

DTAl 

USER 

10 

DTA2 

USER 


The following examples are variations on .DAT slot assignments^ as a 
function of either core size or different peripherals. 


a. Given an 8K system with line printer and card reader: 
LPA should be assigned to .DAT slot-2 and one of the 
positive slots, for example, 3, 7, or 10. CDB should 
be assigned to one of the positive slots. 


^All installations with 16K or more core should assign the "A" versions 
of handlers to all .DAT slots. 
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b. Given a 16K (or greater) Disk/DECtape system, a suggested list 
of assignments might be as follows: 


-15 

DKA2 

-3 

TTA 

-14 

DKAl 

-2 

TTA 

-13 

DKA3 

-1 

DKAO 

-12 

TTA 

1 

DKAl 

-11 

DKAl 

2 

DKA2 

-10 

PRA 

3 

DKA3 

-7 

DKCO 

4 

TTA 

-6 

DKA3 

5 

PRA 

-5 

NONE 

6 

PPA 

-4 

DKA3 

7 

DTAl 



10 

DTA2 


c. Given a 16K (or greater) DECtape system with magnetic tape, a 
suggested list of assignments might be as follows: 


-15 

DTA2 

-3 

TTA 

-14 

DTAl 

-2 

TTA 

-13 

DTA2 

-1 

DTAO 

-12 

TTA 

1 

DTAO 

-11 

DTAl 

2 

DTAl 

-10 

PRA 

3 

DTA2 

-7 

DTCO 

3 

TTA 

-6 

DTA2 

5 

PRA 

-5 

NONE 

6 

PPA 

-4 

DTA2 

7 

MTFl 



10 

MTF2 


4.4.3 Assigning Devices 

Before calling a system or user program, the user should make all device 
assignments necessary to the program(s) to be run. 


The ASSIGN command (see Paragraph 4. 3. 2. 8) is used to attach hardware 
devices to the slots of the device assignment table. Table 4-2 shows 
the normal setup of .DAT. Only system slots -2, -3, and -7 cannot be 
modified by the ASSIGN command, since these must be used by the Monitor. 

System programs use the negative .DAT slots, while user programs should 
use the positive .DAT slots. PIP, FOCAL and EDITVP are exceptions to 
this rule in that they use both the positive and negative .DAT slots. 


4.4.4 Loading Programs in the ADVANCED Monitor Environment 

In the ADVANCED Monitor environment, most system programs are called 
by unique keyboard commands (see paragraph 4.3.1). User programs and 
some system programs (e.g., FOCAL and 8TRAN) are called by loading the 
Linking Loader or DDT (via LOAD, GLOAD, DDTNS, or DDT commands) and 
requesting it to load the desired program. In loading user programs, 
the main program is loaded first, followed by all required subprograms 
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Table 4-2 


Function of .DAT Slots in the ADVANCED Monitor System 

.DAT 


Slot 

Device 

Handler 


Use 


8K 

12K or 
greater 



-15 

DTA2 

DTA2 

Output 

-UPDATE, SGEN, DTCOP 




Input 

-8TRAN, SRCCOM (old file) 




Scratch 

-EDIT, EDITVP 

-14 

DTAl 

DTAl 

Input 

-EDIT, EDITVP, UPDATE, SGEN, DTCOP, 
SRCCOM (new file) , DUMP 




Secondary 

Input 

-MACRO (macro definitions file) 




Input/Output 

-PATCH 




Output 

-8TRAN 

-13 

PPC^ 

DTA2 

Output 

-MACRO, FORTRAN IV 

-12 

TTA 

TTA 

Listing Output 

-MACRO, FORTRAN IV, UPDATE, DUMP, 
SRCCOM 

-11 

PRBO^ 

DTAl 

Input 

-MACRO, FORTRAN IV 

-10 

PRA 

PRA 

Secondary 

Input 

-EDITOR, EDITVP, UPDATE, PATCH, 

MACRO (parameter file) 

-7 

DTCO 

DTCO 

Input 

-System device for the System Loader 

-6 

DTB2 

DTA2 

Output 

-CHAIN (XCT overlay system) 

-5 

NONE 

NONE 

External 

Library 

-Linking Loader, CHAIN, DDT (these 
programs expect the name .LIBR5 BIN 
if a device is assigned) 

-4 

DTC2^ 

DTA2 

Input 

-Linking Loader, DDT, CHAIN, EXECUTE 

-3 

TTA 

TTA 

Output 

-All system programs 

-2 

TTA 

TTA 

Input 

-All system programs 

-1 

DTCO^ 

DTAO 

Input (System 
Library) 

-FORTRAN IV, Linking Loader, CHAIN, 
DDT 

1 

DTAO 

DTAO 

Input/Output 

-PIP, User 

2 

DTAl 

DTAl 

Input/Output 

-PIP, User 

3 

DTA2^ 

DTA2^ 

Input/Output 

-PIE, User 




Input 

-FOCAL library 

4 

TTA 

TTA 

Input/Output 

-User 

5 

PRA^ 

PRA^ 

Input 

-PIP, User 




Output 

-FOCAL library 

6 

PPA 

PPA 

Output 

-PIP, User 

7 

DTAl^ 

DTAl^ 

Input/Output 

-PIP, User 




Input 

-FOCAL (data files) 

10 

DTA2 

•DTA2 

Input/Output 

-PIP, User 




Output 

-EDITVP (display) , FOCAL (data files) 


^Use MACROI or F4I for 8K DECtape I/O 

^ DTC is sufficient for the Linking Loader; however, since the Linking 
Loader shares the handler with the program it loads, this handler should 
be chosen as a function of the requirements of the program to be loaded. 
The same version of the handler should be used for DECtape assignments 
when a handler is required for more than one .DAT slot. 

^Reassign these .DAT slots to appropriate devices when using FOCAL. Use 
DTE if DECtape I/O is desired in 8K. 

'^Reassign this .DAT slot to VPA if EDITVP is to be used. 
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MEMORY MAP A 


MEMORY MAP B 



8K or 16K or 
24K or 32K 



9®10 

^COM AND .SCOM + 3 


,SCOM + I AND ,SCOM +2 


996 


10 


10-0 352 


The System Bootstrap is loaded via The System Bootstrap loads the 

the paper tape reader in HRM mode. ADVANCED Monitor (resident and 

nonresident) from the system device. 

Figure 4-1 ADVANCED Monitor System Memory Maps 

By loading subprograms in the order of size (largest first, smallest 
last) , the user has a better chance of satisfying core requirements for 
his programs in systems with extended core memory. See Figure 4-1 for 
memory maps of programs loaded in the ADVANCED Monitor System. 

When a keyboard command requests a new system program, the ADVANCED 
Monitor loads the System Loader and the system device handler into core. 
The System Loader is basically the Linking Loader in absolute form and 
always requires the same device handler to acquire input from the system 
device. The Linking Loader, on the other hand, is relocatable and 
device independent. 
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MEMORY MAP C 


MEMORY MAP D (SYSTEM PROGRAM IS NOT LINKING LOADER) 



*8K or 16K or 
24K or 32K 



9® 10 

,SCOM 


,SC0M + 3 


,SC0M + 2 


,SC0M + 1 


996io 


10-0351 


The Monitor loads the System Loader and the system 
device handler from the system device via the Bootstrap. 

The System Loader, during loading of a system program 
from the system device, builds the loader (GLOBAL) 
symbol table down from .SCOM+3 and the programs up 
from .SCOM+2. 

The System Loader learns which I/O handlers are required 
by the requested system program from its table of .lODEV 
info for system programs, loads the handlers relocatably 
just above the resident Monitor*, and then modifies the 
System Bootstrap to bring in the system program in just 
below the Bootstrap. 


.EXIT from the system program takes the process 
back to Memory Map B where the system bootstrap 
reinitializes the ADVANCED Monitor. 

Refer to Section 5.4 for the sizes of the device 
handlers that may be associated with the .DAT slots 
used by the system program. 

*For 1 2K, 20K, or 28K systems, handlers are loaded 
up into the extra 4K, then up from .SCOM+2 if neces- 
sary. .SCOM +20 is set to the first address above the 
I/O handlers in the extra 4K with the sign bit = 1 . 


Figure 4-1 ADVANCED Monitor System Memory Maps (Cont.) 
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MEMORY MAP F (NOT DDT OR DDTNS) 


8K or 16K or 
24K or 32K 
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1 HANDLER SIZES. 

^COM + 1 


996 


10 


*8K or 16Kor 
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SYSTEM 
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PROGRAM(S) 


USER DEVICE 
HANDLER 


USER DEVICE 
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USER DEVICE 
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LINKING LOADER 
DEVICE HANDLER 


LINKING LOADER 
DEVICE HANDLER 


RESIDENT 

MONITOR 

(INCLUDING 

TELETYPE 

HANDLER) 


96,0 


,SCOM 


.SCOM + 3 


(b.) 


(a) 


996 


10 


10-0350 


09-0220 


The System Loader learns which I/O handlers are required by the 
Linking Loader, loads them relocatably, and then loads the Linking 
Loader relocatably. 

If a DDT load, the Linking Loader just prior to giving control to 
DDT moves the DDT symbol table down in core so that it overlays 
all of the Linking Loader except for the small routine that makes 
the block transfer. 

The Linking Loader, during loading of user programs down from 
.SCOM+3*, builds the loader (GLOBAL) and DDT (if DDT) symbol 
tables up from .SCOM+2. DDT symbol table will not be built if a 
LOAD. GLOAD, or DDTNS load. 


.EXIT from user program takes the process back to Memory Map B 
where the system bootstrap reinitializes the ADVANCED Monitor. 

Refer to Section 5.4 for sizes of device handlers. 

•SCOM+l and .SCOM+2 both point to one of two places and non- 
BLOCK DATA COMMON (FORTRAN IV or MACRO) output make 
use of core as low as they point. 

a. If the user program did not have any device handlers in 
common with the Linking Loader. 

b. If the user program did have at least one device handler in 
■ common with the Linking Loader. 


*In 12K, 20K, or 28K systems DDT, user programs and user 1/0 handlers are first loaded down from the top of the extra 4K, .SCOM+2 and .SCOM+3 
bracket free core. .SCOM+20 points to the first free cell below the routines in the extra 4K with SCOM+20, bit 0=1. 

Figure 4-1 ADVANCED Monitor System Memory Maps (Cont.) 
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MEMORY MAP G (DDT OR ODTNS) 
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• EXIT froml'he user program takes the process back to Memory 
Map B where the system bootstrap reinitializes the Monitor, 

Refer to Section 5,4 for sizes of device handlers, 

Non-BLOCK DATA COMMON (FORTRAN IV or MACRO 
output) may make use of core as low as the DDT symbol table, 
(There is no DDT symbol table if a DDTNS load,) However, 
trouble will occur if the user requests DDT to create symbols 
or make patches that cause overlaying of the COMMON area. 

The Linking Loader device handlers would have been used to 
satisfy user device requests. 

If none of these handlers is used by user program, these 
handlers are overlaid also by the DDT symbol table. 

*ln 12K, 20K, or 28K systems DDT, user programs and user 
I/O handlers are first loaded down from the top of the extra 
4K, then down from ,SCOM+3 if necessary. When the load- 
ing process is complete, ,SCOM+2 and ,SCOM^-3 bracket 
free core, ,SCOM+20 points to the first free cell below the 
routines in the extra 4K with ,SCOM+20, bit 0=1 


The System Loader (,SYSLD) opens the XCT file to 
determine the handlers required by the Overlay 
System, It then loads the handler required for 
EXECUTE and then EXECUTE itself, followed by 
the Overlay System's device handlers. Control 
is then passed to EXECUTE which loads the Link 
Table, the Resident Code, and the main program, 
to which control then passes, .EXIT from the 
Overlay System initiates a return to the Monitor 
via Memory Map B, 

**lf an extra 4K of core is to be used by the 
Overlay System (e,g,, I2K, 20K, etc,), 

EXECUTE will attempt to load as much of the 
Overlay System as possible from the top of the 
extra 4K down and the remainder from ,SCOM 
down. 


Figure 4-1 ADVANCED Monitor System Memory Maps (Cont.) 
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The System Loader is used to bring in most system programs, including 
the Linking Loader, and their associated device handlers. Once loaded, 
the Linking Loader is used to bring in user programs, their subroutines, 
and device handlers. 

The System Loader can print the same error messages as the Linking 
Loader (see Appendix D) , except that it precedes the error code with 
the symbol .SYSLD. It returns control to the System Bootstrap to 
re-initialize the ADVANCED Monitor if an error occurs. 

Once a system program is loaded by the System Loader, the loaded 
program assumes control. At this stage, it is ready to accept an input 
command string from the keyboard telling it how to proceed. Detailed 
operating procedures for each system program are given in the PDP-15/20 
Users Guide. 

4.4.5 Error Detection and Handling 

Comprehensive error checking is provided by the ADVANCED Monitor, the 
loaders, and the Input/Output Programming System. Detailed lists of 
errors that may occur are given in Appendices C, D, and E, respectively. 
After error messages are output, the user may optionally restart the 
system (CTRL P) or user program, dump core (CTRL Q) , or return control 
to the System Bootstrap for re-initialization of the Monitor (see 
Section 4.3.2.11). If QDUMP has been issued prior to execution of 
this program, an automatic CTRL Q (dump the current job, in core image, 
onto prespecified blocks of the system device) takes place before con- 
trol is returned to the System Bootstrap. The number of the unit to be 
used as the dump device must be typed by the user after the error 
typeout. This dumped file can be selectively listed by the system 
Dump program. If HALT has been typed prior to program execution, the 
program stops after error message typeout, allowing manual memory cell 
examination, manual restart, or core dump. 

4.5 BATCH PROCESSING 

The Batch Processor portion of the Monitor allows user commands to 
come from the paper tape reader or card reader instead of the Teletype, 
allowing many programs to be run without operator intervention. All 
Monitor commands read on the batch device are echoed on the teleprinter. 
Monitor commands that are peculiar to the Batch Processor include the 
following : 
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BATCH (B) dv Enter Batch mode with dv as batch device; 
dv can be typed as 

PR for paper tape reader, or 

CD, for card reader 


NOTE 

When using the card reader, the following 
special characters are punched as shown: 

Back Arrow (■«-) = 0-5-8 (029) or 8-2 (026) 

ALT MODE = 12-1-8 (029 or 026) 

$JOB Used to separate jobs (the loading of any 

system or user program constitutes a 
single job) . 

$DATA Beginning of data - all inputs up to $END 

are not echoed on the teleprinter. 

$END End of data. 

$EXIT Leave Batch mode. 

NOTE 

The following commands are illegal when 
operating in Batch mode: QDUMP , HALT, 

GET (all forms), BATCH, LOAD, DDT, and 
DDTNS . 


Special Batch Processor control characters include the following: 

CTRL T (echoes IT) Skip to next job. 

CTRL C (echoes iC) Leave Batch mode. 

To use the Batch Processor, proceed as follows: 

a. Load the batch tape or deck into the batch device. 

b. Type BATCH (or B) dv on the keyboard, where dv is PR or CD. 


When operating in Batch mode, the ADVANCED Monitor has the following 
operational changes : 


a. Any ASSIGN command that references the batch device (any 
handler) will be assigned to the batch device handler. 

b. Any REQUEST command will print the batch device handler 
PR* or CD* (whichever applies) . 

c. When the non-resident Monitor is reloaded, it interprets 
batch communication bits in the top register of core 
(177777, 377777, 577777, or 777777): 
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Bit 0 


1 = Batch mode 
0 = Non-batch mode 

Bit 1 1 = $JOB command in 

0 = Search for $JOB 

Bit 2 1 = CD is batch device 

0 = PR is batch device 

When an error occurs in a job, the non-resident Monitor is reloaded and 
the Batch Processor skips to the next $JOB command on the batch device. 

The following example was produced under control of the Batch 
processor. Underlined commands are on paper tape. ALT MODE termina- 
tion is indicated with an 


Km5 V5A 
$X4K ON 


$8ATCH PR 
K:115 V5A 

$$ J0.B TEST BATCH 
$ PIP 

PIP VI 3 A 
> N DTI 

> T DTI TEST SRC PR 

S DATA 

S END 

>$J03 

KM 15 V5A 


This command causes all subsequent 
commands to come from the paper 
tape reader. 


The entire program to be compiled 
below appears on the paper tape 
between $DATA and $END. 


$R F4 




.DAT 

DEVICE 

USE 


-13 

PPC0 

OUTPUT 


-12 

TTA0 

LISTING 


-11 

PR*0 

INPUT 


-3 

TTA0 

CONTROL 

AND ERROR 

-2 

PR*0 

COMMAND 

STRING 

S AS SIGN 

DTI -1 1/DT2 -13 



SB 


FA VI OA ^ 
> S,L,B<-TEST @ 
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END PAS51 


C 

C TEST OF BATCH PROCESSOR 

C 

DO 1 1=1,10 

1 WRITE (4,100) I 

100 FORMAT (6X,I3) 

STOP 12345 
END 



.1 

00012 


I 

00043 

♦ 

.FW 

00036 


.100 

00021 

* 

.fe 

00037 

* 

.FF 

00040 

* 

• ST 

00041 


• FP 

00042 


FORTRAN program to list numbers 
from 1 through 10 . 


KM15 V5A 

$$J0B 

SGLOAD 


LOADER VDA 


P 

TEST 

27754 

P 

BCDIO 

24676 

P 

STOP 

24663 

P 

SPMSG 

24570 

P 

Flops 

24030 

P 

OTSER 

23734 

P 

RELEAE 

22672 

P 

• CB 

22652 


Program execution begins here. 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

STOP 012345 


KM15 V5A 

$ $J03 

$ $EXIT 

Control is returned to Teletype at 
KM15 V5A this point 


$ 


4-31 



4.6 DECTAPE FILE ORGANIZATION 


DECtape can be treated either as a non-file-oriented medium or as a 
file-oriented medium, as described in the following paragraphs. 

4.6.1 Non-File-Oriented DECtape 

A DECtape is said to be non-file-oriented when it is treated as magnetic 
tape by issuing the MTAPE commands: REWIND, BACKSPACE, followed by 
.READ or .WRITE. No directory of identifying information of any kind 
is recorded on the tape. A block of data (255^^ word maximum) , exactly 
as presented by the user program, is transferred into the handler buffer 
and recorded at each .WRITE command. A .CLOSE terminates recording with 
a simulated end-of-file consisting of two words: 001005, 776773. Note 
that the simulated end-of-file is identical whether executing a .CLOSE 
in a file-oriented or a non-file-oriented environment. 

Because braking on DECtape allows for tape roll, staggered recording of 
blocks is employed in the ADVANCED Software System to avoid constant 
turnaround or time-consuming back and forth motion of sequential block 
recording. When recorded as a non-f ile-oriented DECtape, block 0 is the 
first block recorded in the forward direction. Thereafter, every fifth 
block is recorded until the end of the tape is reached, at which time 
recording, also staggered, begins in the reverse direction. Five passes 
over the tape are required to record 576 ^q blocks (0-1077g) . 

4.6.2 File-Oriented DECtape 

Just as a REWIND command declares a DECtape to be non-file-oriented, a 
.SEEK or .ENTER implies that a DECtape is to be considered file-oriented. 
The term file-oriented means simply that a directory containing file 
information exists on the DECtape. A directory listing of any DECtape 
so recorded is available via the (L) ist command in PIP or the (D) irect 
command in the ADVANCED Monitor. A fresh directory may be recorded 
via the (N) ewdir command in the ADVANCED Monitor or PIP or by the N or 
S switch in PIP. 

The directory of all DECtapes except system tapes occupies all 400g 
words of block lOOg. It is divided into two sections: (1) a 40gWord 
Directory Bit Map and (2) a 340 g word Directory Entry Section. 

The Directory Bit Map defines block availability. One bit is allocated 
for each DECtape block (576^^ bits = 32^^ words) , When set to 1, the 
bit indicates that the DECtape block is occupied and may not be used 
to record new information. 

The Directory Entry Section provides for a maximum of files on a 
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DECtape on a system tape) . A four-word entry exists for each file 

on DECtape, where each entry includes the 6-bit trimmed ASCII file name 
(6 characters maximum), and file name extension (3 characters maximum) , 
a pointer to the first DECtape block of the file, and a file active or 
present bit. 

On a system tape only the first 200o words are used as a 24 file directory. 

O 

Words 0-37 o constitute the System Tape Directory Bit Map and words 

O 

40-177g contain 24 file directory Entry Section. The second 200g words 
of DECtape block lOO^ contain basic system directory information (blocks 

O 

occupied by system programs), used by the Monitor, PIP, and SGEN. 



Directory 
Bit Map 


Directory 

Entry 

Section 


A DIRECTORY ENTRY 

Wd. 0 
1 
2 

3 


0 56 11 12 17 



Fi le 



Name 


File Name Extension 

1 

Data Link (First File Block) 


Sign Bit: 1 = File Active 


Note: Nulls (0) fill in 
short file names. A file 
name extension is not 
absolutely necessary. 


Figure 4-2 DECtape Directory 


Additional file information is stored in blocks 71 through 77 of every 
file-oriented DECtape (blocks 71 through 73 of a system tape) . These 
are the File Bit Map Blocks. For each file in the directory, a 40g 
word File Bit Map is reserved in block 71 through 77 as a function of 
file name position in the Directory Entry Section of block 100. Each 
block is divided into eight File Bit Map Blocks. A File Bit Map 
specifies the blocks occupied by that particular file and provides a 
rapid, convenient method to perform DECtape storage retrieval for 
deleted or replaced files. Note that a file is never deleted until the 
new one of the same name is completely recorded on the .CLOSE of the 
new file. 
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When a fresh directory is written on DECtape, Blocks 71 through 100 are 
always indicated as occupied in the Directory Bit Map. 

Staggered recording (at least every fifth block) is used on file- 
oriented DECtapes, where the first block to be recorded is determined 
by examination of the Directory Bit Map for a free block. The first 
block is always recorded in the forward direction; thereafter, free 
blocks are chosen which are at least five beyond the last one recorded. 
The last word of each data block recorded contains a data link or 
pointer to the next block in the file. When turnaround is necessary, 
recording proceeds in the same manner in the opposite direction. When 
reading, turnaround is determined by examining the data link. If 
reading has been in the forward direction, and the data link is 
smaller than the last block read, turnaround is required. If reverse, 
a block number greater than the last block read implies turnaround. 



Figure 4-3 DECtape File Bit Map Blocks 


A simulated end-of-file terminates every file and consists of a two 
word header (1005, 776773) as the last line recorded. The data link 
of this final block is 777777. 

Section 2.3.1 of this manual discusses lOPS data modes. Data organiza- 
tion for each I/O medium is a function of these data modes. On file- 
oriented DECtape there are two forms in which data is recorded: 
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(1) packed lines - lOPS ASCII, lOPS binary, Image Alphanumeric, and 
Image binary and (2) dump mode data - Dump Mode. 

In lOPS or Image Modes, each line (including header) is packed into the 
DECtape buffer. A 2's complement checksum is computed and stored for 
each line of information. When a line is encountered which will 
exceed the remaining buffer capacity, the buffer is output, after which 
the new line is placed in the empty buffer. line may exceed 254 ^^ 

words, including header, because of the data link a nd e ven word regui:^- 
ment of the header word pair count. An end-of-file is recorded on a 
.CLOSE. It is packed in the same manner as any other line; that is, if 
the buffer will not contain it, the line goes into the next available 
free block. 

In Dump Mode , the word count is always taken from the I/O macro. If 
a word count is specified which is greater than 255^^ (note that space 
for the data link must be allowed for again) , the DECtape handler will 
transfer 255^^^ word increments into the DECtape buffer and from there 
to DECtape. If some number of words less than 255^^ remain as the final 
element of the Dump Mode .WRITE, they will be stored in the DECtape 
buffer, which will then be filled on the next .WRITE, or with an EOF 
if the next command is .CLOSE. DECtape storage use is thus optimized 
in Dump Mode since data is stored back to back without headers. 

4.7 RF15 DECDISK 

4.7.1 General Description 

The PDP-15/20 DECdisk System accommodates up to four RS15 DECdisk 
Platters which communicate with the device handlers via the RF15 con- 
troller. Each platter is treated as two logical units, each of which 
contains 512^^^ blocks. Each block contains 256^^ words. 

4.7.2 File Structure 

The file structure of the RF15 DECdisk is the same as that used for 
DECtape (see 4.6 above) with the following exceptions: 

a. Each DECdisk unit is 64^^ blocks shorter than a DECtape. 

Since the handlers are similar in structure to DECtape, 
they will always indicate that blocks 512^^ through 
576io are occupied; where, in fact, they do not exist. 

b. Reading and writing is performed in one direction only. 

4.7.3 Disk File Protection 

Selected areas of a disk platter may be write-protected by use of the 
switches provided on each RS15 Platter control panel. Each switch 
protects 40, 000 g words. 
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4.8 MAGNETIC TAPE 


The ADVANCED Software provides for industry-compatible magnetic tape 
as either a file-structured or non-file-structured medium. The magnetic 
tape handlers communicate with a single TC-59 Tape Control Unit (TCU) . 

Up to eight magnetic tape transports may be associated with one TCU; 
these may include any combination of transports TU-20 and TU-20A. 

There are a number of major differences between magnetic tape and other 
mass-storage devices (for example, DECtape or Disk); these differences 
affect the operation of the device handlers. Magnetic tape is well 
suited for handling data records of variable length; such records, how- 
ever, must be treated in serial fashion. The physical position of any 
record may be defined only in relation to the preceding record. Block- 
addressable devices are most economically used in transferring records 
having fixed lengths that are hardware-constrained. Using such devices, 
the absolute physical location of any record is program-specifiable. 
Because of the serial character of data blocks as they are recorded on 
magnetic tape and because of the presence of blocks of unknown length, 
three techniques available in I/O operations to block-addressable de- 
vices are' not honored by the magnetic tape handlers: 

a. The user cannot specify physical block numbers for transfer. 

In processing I/O requests that have block numbers in their 
argument lists (i.e., .TRAN) the handler ignores the block- 
number specification. 

b. The only area open for output transfers in the file- 
structured environment is that following the current logical 
end of tape. The exception to this rule is in the record- 
ing of the File Directory as explained below. 

c. Only a single file may be open for transfers (either input 
or output) at any time on a single physical unit. 

4.8.1 File Organization 

The device handlers for magnetic tape allow the use of either a file 
structured or a non-file structured mode. Handler MTA. enables both 
reading and writing in the file structured mode; handler MTC. (a subset 
of MTA.) permits reading in the file structured mode only. Handler 
MTF . enables reading and writing in the non— file structured mode. 

The legal functions and data modes for each of the magnetic tape handlers 
are described in paragraph 5.4.6. 
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4. 8. 1.1 Non-File-Structured Data Recording (MTF . ) - The treatment of 
data to be recorded or read in non-file-structured fashion has two 
primary objectives. It is intended to satisfy the requirements of the 
FORTRAN programmer while still providing the assembly language pro- 
grammer maximum freedom in the design of his tape format. Magnetic tape 
data, written in the non-file-oriented environment, differs in two im- 
portant respects from data recorded by means of file-oriented I/O re- 
quests. In the first place, no handler-supplied supplementary informa- 
tion is written on the tape. No reference is made, for example, to a 
file directory, and block-control data (see below) is never written. 
Secondly, no blocking (or packing) of lines is performed by the handler. 
Each .WRITE (or .READ) request causes direct data transfer between the 
user's line buffer and the TCU. No buffering or editing of any kind is 
done. Each .WRITE (or .READ) issued results, in general, in the trans- 
fer of exactly one physical record to (or from) tape. 

4. 8.1.2 File-Structured Data Recording (MTA. , MTC.) - The programmer 
can make the fullest possible use of those features peculiar to magnetic 
tape by employing non-file-oriented transfer techniques. On the other 
hand, he has little recourse to the powerful file-manipulation facilities 
available in the system. File-structured I/O brings to bear the whole 
body of file-system software, gives true device independence to the 
magnetic tape user, and allows extensive use of the storage medium 

with a minimum of effort. 

4. 8.1. 3 Block Format - Every block recorded by MTA. (with the exception 
of end-of-file markers, which are hardware-recorded) in file-structured 
mode includes a two-word Block Control Pair and not more than 255^0 
words of data. 

The Block Control Pair serves three functions: it specifies the 
character of the block (label, data, etc.), provides a word count for 
the block, and gives an 18-bit block checksum. The Block Control Pair 
has the following format: 

Word 1 ; 

Bits 0 through 5: Block Identifier (BI) . This 6-bit 
byte specifies the block type. Values of BI may range 
from 0 to 77 g. Current legal values of BI , for all 
user files, are as follows: 
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BI Value 


Block Type Specified 


00 

10 

20 


User-File Header Label 
User-File Trailer Label 
User-File Data Block 


Bits 6 through 17: Block Word Count (BWC) . This 12-bit 

byte holds the 2's complement of the total number of 

words in the block (including the Block Control Pair) . 

Legal values of BWC range from -3 to -401o. 

0 


Word 2 : 

Bits 0 through 17: Block Checksum. The Block Checksum 
is the full-word, unsigned, 2's complement sum of all the 
data words in the block and word 1 of the Block Control 
Pair. 


0 5 6 17 



09-0 2 30 


Figure 4-4 Block Format, File-Structured Mode 


4.8.2 File Identification and Location 

One of* the main file-manipulation functions of MTA. and MTC. is that of 
identifying and locating referenced files. This is carried out by two 
means: first, names of files recorded are stored in a file directory at 

the beginning of the tape; and second, labels integral to the file are 
recorded with the file itself. 


4. 8. 2.1 Magnetic Tape File Directory - The directory, a single-block 
file (and the only unlabeled file on any file-structured tape) , con- 
sists of the first recorded data block on the tape. It is a fixed- 
length block with a constant size of 257^^ words and the following 
characteristics ; 


a. Block Control Pair (words 1 and 2) 

Word 1: 

Block Identifier = 74^ = File Directory Data Block 
Block Word Count = -401g = 7377g. 
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Word 2 ; 


Block Checksum; As described 

b. Active File Count (Word 3, Bits 9 through 17) 9-bit one's 
complement count of the active file names present in *the 
File Name Entry Section (described below) . 

c. Total File Count (Word 3, Bits 0 through 8) 9-bit one's 
complement count of all files recorded on the tape, in- 
cluding both active and inactive files, but exclusive of 
the file directory block. 

d. File Accessibility Map (Words 4 through 17) ; The File 
Accessibility Map is an array of 252 contiguous bits 
beginning at bit 0 of word 4 and ending as bit 17 of 

word 17. Each of the bits in the Accessibility Map refers 
to a single file recorded on tape. The bits are assigned 
relative to the zero"^^ file recorded; that is, bit 0 of 
word 4 refers to the first file recorded; bit 1, word 4, 
to the second file recorded; bit 0, word 6, to the 37,-, 
file recorded; and so on, for a possible total of 
252 ^q files physically present. 

A file is only accessible for reading if its bit in the 
Accessibility Map is set to one. A file is made 
inaccessible for reading (corresponding bit =0) by a 
. DLETE of the file, by a .CLOSE (output) of another file 
of the same name, or by a .CLEAR. A file is made 
accessible for reading (corresponding bit = 1) by a .CLOSE 
(output) of that file. Operations other than those 
specified above have no effect on the File Accessibility 
Map . 

e. File Name Entry Section (Words 18 through 257) : The File 
Name Entry Section, beginning at word 18 of the directory 
block, includes successive 3-word file name entries for a 
possible maximum of 80 entries. Each accessible file on 
the tape has an entry in this section. Entries consist 

of the current name of the referenced file in standard DEB 
format: file name proper in the first two words, extension 

in the third word; 6-bit trimmed ASCII characters, left- 
adjusted and, if necessary, zero-filled. 

The position of a file name entry relative to the beginning 
of the section reflects the position of its accessibility 
bit in the map. That bit, in turn, defines the position 
of the referenced file on tape with respect to other (active 
or inactive) files physically present. Only active file 
names appear in the entry section, and accessibility bits 
for all inactive files on the tape are always set to zero; 
accessibility bits for all active files are set to one. 

To locate a file on the tape having a name that occupies 
the second entry group in the File Name Entry Section, the 
handler must (a) scan the Accessibility Map for the second 
appearance of a 1-bit, then (b) determine that bit's loca- 
tion relative to the start of the map. That location 
specifies the position of the referenced file relative to 
the beginning of the tape. The interaction of the File 
Name Entry Section and the Accessibility Map is shown in 
figure 4-5 . 


4. 8.2.2 User-File Labels - Associated with each file on tape are two 
identifying labels. The first is a header label and precedes the first 
data block of the file; the second, a trailer label, follows the final 
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recorded data block of the file. Each label is 27^^ words in length. 
Label format is shown in Figure 4-6. 

Note that the trailer label differs from the header label only in the 
contents of the BI field and in that the former includes an indication 
(Word 4) of the total blocks recorded in the file. The total includes 
the two labels themselves. 


4. 8. 2. 3 File-Names in Labels - The handler will supply the contents 
of the file-name fields (Word 3) in labels. These are used only for 
control purposes during the execution of .SEEKS. The name consists 
simply of the two's complement of the position of the recorded file's 
bit in the Accessibility Map; the "name" of the first file on tape is 
777777, that of the third file is 777775, and so on. A unique name is 
thus provided for each file physically present on the tape. Since 
there may be a maximum of 252^^ files present, legal file-name values 
lie in the range 777777 to 777404. 


4.8.3 Continuous Operation 

Under certain circumstances, it is possible to perform successive I/O 
transfers without incurring the shut-down delay that normally takes 
place between blocks. The handler stacks transfer requests, and thus 
ensures continued tape motion, under the following conditions: 


a. The I/O request must be received by the CAL handler before 
a previously-initiated I/O transfer has been completed. 

b. The unit number must be identical to that of the previously- 
initiated I/O transfer. 

c. The I/O request must be one which requires an implicit .WAIT 
to ensure successful completion. The handler in processing 
requests in continuous mode depends on receiving control at 
the CAL level in order to respond to I/O errors. In addition, 
an explicit .WAIT command should not be issued (see examples 

1 and 2 given below) . The functions for which continuous 
operation is attempted include only the following: 


1. .MTAPE 3. .WRITE 

2. .READ 4. .TRAN 


d. The previously-requested transfer must be completed without 
error. In general, successive error-free READS (WRITES) to 
the same transport will achieve non-stop operation. The 
following examples illustrate this principle. 

Example 1: Successful Continued Operation 


SLOT = 1 
INPUT = 0 
BLOKNO = 0 
RE ADI 
READ2 
RETURN 


.TRAN SLOT, INPUT, BLOCKNO , BUFFI, 257 
.TRAN SLOT, INPUT, BLOCKNO, BUFF2 , 257 
JMP RE ADI 
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Figure 4-6a. User-File Header 
Label Format 


Figure 4-6b. User-File Trailer 
Label Format 


The program segment in Example 1 will most probably keep the referenced 
transport (.DAT slot 1) up to speed. The probability decreases as more 
time elapses between READl and READ 2 , and between READ2 and RETURN. 

Each .TRAN request causes an implicit .WAIT until its operation is 
completed. 


Example 2 : 

SLOT = 1 
INPUT = 0 
BLOKNO = 0 
READ 
ST05 
RETURN 


Unsuccessful Continued Operation 


.TRAN SLOT, INPUT, BLOKNO, BUFF, 257 
.WAIT SLOT 
JMP READ 


The program segment in Example 2 will not keep the tape moving because 
the explicit .WAIT at location STOP prevents control from returning to 
location READ until the transfer first initiated at READ has been com- 
pleted. 


Example 3: 

SLOTl = 1 
SLOT2 = 2 
INPUT = 0 
BLOKNO = 0 
READl 
RE AD 2 
RETURN 


Unsuccessful Continued Operation. 


.TRAN SLOTl, INPUT, BLOKNO, BUFFI, 257 
.TRAN SLOT2, INPUT, BLOKNO, BUFF2 , 257 
JMP READl 


This program segment will not provide non-stop operation because of the 
differing unit specification at READl and READ2 . 
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4.8.4 Storage Retrieval on File-Structured Magnetic Tape 

The use of a file accessibility map as well as block identifiers in 
MAGtape file directories makes it almost impossible to retrieve the 
area of a deleted file from a magnetic tape. The execution of the 
deletion command (i.e., .DLETE) removes the name of the object file 
from the file directory; however, the file accessibility map will con- 
tinue to reflect the presence of the file on the tape. 

The only circumstance under which a file area may be retrieved is when 
the deleted file is also the last file, physically, on the tape. Under 
these conditions, the handler can effect retrieval of the area occupied 
by the deleted file when the next .ENTER- .WRITE- .CLOSE sequence is 
executed, 

4.8.5 Magnetic Tape Dump (MTDUMP) Utility Program 

The MTDUMP program provides the user who employs magnetic tape as a 
storage medium with the ability to view and manipulate any named 
portion (i.e., file) of a tape. Some of the features provided by 
MTDUMP are ; 

a. Files may be output (dumped) onto any system device in 
any of four possible formats. 

b. Comments may be inserted into any output file. 

c. Files may be copied onto another tape. 


A complete description of the features and operation of the MTDUMP 
program is given in the PDP-15 Utility Manual. 
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CHAPTER 5 


I/O DEVICE HANDLERS 


This chapter contains information essential to a good understanding of 
the operation and use of the ADVANCED Monitor I/O device handlers. A 
general description of I/O hardware and API software level handlers, a 
complete section on writing special I/O device handlers, a summary of 
I/O handlers acceptable to system programs, and a summary of standard 
I/O handler features are included in this chapter. 

5.1 DESCRIPTION OF I/O HARDWARE AND API SOFTWARE LEVEL HANDLERS 

5.1.1 I/O Device Handlers 

All communications between user programs and I/O device handlers are 
made via CAL instructions (see Chapter 3) followed by an argument list. 
The CAL Handler in the Monitor (see Figure 5-1) performs preliminary 
setups, checks on the CAL calling sequence, and transfers control via 
a JMP* instruction to the entry point of the device handler. When the 
control transfer occurs (see Figures 5-2 and 5-3) , the AC contains the 
address of the CAL in bits 3 through 17 and bits 0, 1, and 2 indicate 
the status of the Link, Bank/Page mode, and Memory Protect, respectively, 
at the time of the CAL. Note that the content of the AC at the time of 
the CAL is not preserved when control is returned to the user. 

On machines that have an API, the execution of a CAL instruction auto- 
matically raises the priority to the highest software level (level 4). 
Control passes to the handler while it is still at level 4, allowing 
the handler to complete its non-reentrant procedures before debreaking 
(DBK) from level 4. This permits the handler to receive reentrant 
calls from software levels higher than the priority of the program that 
contained this call. Device handlers which do not contain reentrant 
procedures (including all lOPS handlers) , may avoid system failure 
caused by inadvertent reentries by remaining at level 4 until control 
is returned to the user. 

If the non-reentrant method is used, the debreak and restore (DBR) 
instruction should be executed just prior to the JMP* which returns 
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Figure 5-2, CAL Entry To Device Handler. 
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Figure 5-3, PI and API Entries to Device Handlers 
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control to the user, allowing debreak from level 4 and restoring the 
conditions of the Link, Bank/Page mode, and Memory Protect. Any lOT ' s 
issued at the CAL level (level 4 if API present, mainstream if no API) 
should be executed immediately before the 

DBR 

JMP* 


exit sequence to ensure that the exit takes place before the interrupt 
from the issued lOT occurs. 

The CAL instruction must not be used at any hardware priority level 
(API or PIC) , since interrupts to these levels are not closed out by 
the execution of a CAL and recovery is not possible from such sequence 
of events as 


a. An I/O flag coming up during a CAL at level 7, 

b. Control going to the I/O device handler at level 3, 

c. The handler at level 3 CALing and thus destroying the 
content of location 00020 for the previous CAL. 

The highest API software level (level 4) is also used for processing 
CALs and care must be taken when executing CALS at this level. For 
example, a routine that is CALd from level 4 must know that if a 
debreak (DBR or DBK) is issued, control will return to the calling 
program (which had been at level 4) at a level lower than level 4. 


5.1. 1.1 Setting Up the Skip Chain and API (Hardware) Channel 
Registers - When the Monitor is loaded, the Program Interrupt (PI) 
skip chain and the Automatic Priority Interrupt (API) channels are set 
up to handle the TTY keyboard and printer and clock interrupts 
only. The skip chain contains the other skip lOT instructions, but 
indirect jumps to an error routine result if a skip occurs, as follows 


SKPDTA 

SKP 

JMP* INTI 
SKP LPT 
SKP 

JMP* INT2 

SKPTTI 

SKP 

JMP TELINT 


/Skip if DECtape flag. 

/INTI contains error address. 

/Skip if line printer flag. 

/INT2 contains error address. 

/Skip if teleprinter flag. 

/To teleprinter interrupt handler. 


All unused API channels also contain JMP ' s to the error address. 
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When a device handler is called for the first time via an .INIT user 
program command, it must call a Monitor routine (.SETUP) to set up its 
ship chain entry or entries and API channel, prior to performing any 
I/O functions. The calling sequence is as follows: 


CAL N 


16 

SKP lOT 

DEVINT 

(normal 


/N = API channel register 40 through 77 (see 
/section 5.1.3 for standard channel assign- 
/ments) , 0 if device not connected to API. 
/.SETUP function code. 

/Skip lOT for this device. 

/Address of interrupt handler. 

return) 


DEVINT exists in the device handler in the following format to allow 
for either API or PI interrupts. Users with Pl-only systems may exclude 
code from DEVINT-1 through DVSTON-1, in which case DEVINT=DEVPIC is 
required. Users who always expect to use API may exclude code from 
DEVPIC through DEVINT-1, in which case DEVINT 0 should be substituted. 


DEVPIC 

DAC 

LAC* 

DEVAC 

(0 

/SAVE AC. 


DAC 

DEVOUT 

/SAVE PC, LINK.EX.MODE , MEM.PROT. 


LAC 

JMP 

DEVION 

DVSTON 

/FORCE ION AT DISMISSAL 

DEVINT 

JMP 

DEVPIC 

/PIC ENTRY. 


DAC 

LAC 

DEVAC 

DEVINT 

/API ENTRY, SAVE AC. 


DAC 

lORS 

sma: cla 

DEVOUT 

/SAVE PC, LINK, EX. MODE, MEM.PROT. 

/CHECK STATUS OF PIC 

/FOR RESTORATION AT DISMISSAL. 


LAW 

17740 

/PIC OFF, BUILD lOF lOT . 


TAD 

DEVION 

/PIC ON, BUILD ION lOT. 

DVSTON 

DAC 

DEVCF 

DVSWCH 

/CLEAR DEVICE DONE FLAG 

DEVI ON 

ION 

lOF 

DEVIOT 


/ENABLE PIC SO THAT OTHER DEVICES 
/AREN'T SHUT OUT. 

/DISABLE PIC TO INSURE 
/DISMISSAL BEFORE INTERRUPT 
/FROM THIS lOT OCCURS 

/DISMISS ROUTINE 



LAC 

DEVAC 

/RESTORE AC 

DVSWCH 

XX 

DBR 


/ION OR lOF 

/DEBREAK AND RESTORE CONDITIONS 


JMP* 

DEVOUT 

/OF LINK, EX. MODE AND MEM.PROT. 
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since the Index, Autoincrement, and EAE registers are not used by the 
standard I/O device handlers, it is not necessary to save and restore 

them. 

The Monitor routine (.SETUP) checks the skip chain for the instruction 
which matches SKP lOT; if there is a match, it places the address, 
DEVINT, in the appropriate transfer vector (INTn) and places JMS*INTn in 
the corresponding API channel register. If a match cannot be found, 
lOPS outputs the following error message, 

.lOPS 05 XXXXXX 

indicating that the skip lOT in the CAL calling sequence at location 
XXXXXX was not in the skip. 

Refer to Paragraph 5.2 for the method of incorporating new handlers 
and associated skip chain entries into the Monitor. 

5.1.2 API Software Level Handlers 

The information presented in the following paragraphs assumes that the 
reader is familiar with the system input/output considerations described 
in the PDP-15 User's Handbook Vol 1. 

5. 1.2.1 Setting Up API Software Level Channel Registers - When the 
Monitor is loaded, the API software-level channel registers (40 
through 43) are initialized to 


JMS* 

.SCOM+12 

/LEVEL 

4 

JMS* 

.SCOM+13 

/LEVEL 

5 

JMS* 

. SCOM+14 

/LEVEL 

6 

JMS* 

.SCOM+15 

/LEVEL 

7 


where .SCOM is equal to absolute location 000100 and .SCOM+12 through 
.SCOM+15 (000112 through 000115) each contains the address of an 
error routine. 

Therefore, prior to requesting any interrupts at these software 
priority levels, the user must modify the contents of the .SCOM 
registers so that they point to the entry point of the user's software 
level handlers. 

Example : 


.SCOM=100 

LAC (LV5INT 

DAC* (.SCOM+13 
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LV5INT exists in the user's area in the following format: 


LV5INT 0 /PC, LINK, BANK/PAGE MODE , MEM . PROT . 

DAC SAV5AC /SAVE AC 

/SAVE INDEX, AUTOINCREMENT AND EAE REGISTERS 
/IF LEVEL 5 ROUTINES 
/USE THEM AND LOWER LEVEL 
/ROUTINES ALSO USE THEM 
/SAVE MQ AND STEP COUNTER 
/IF SYSTEM HAS EAE AND IT 
/IS USED AT DIFFERENT LEVELS. 


/RESTORE SAVED REGISTERS. 

DBR /DEBREAK FROM LEVEL 5 

JMP* LV5INT /AND RESTORE L, BANK/PAGE MODE , MEM . PROT . 

5. 1.2. 2 Queueing - Pligh priori ty /high data rate/short access routines 
cannot perform complex calculations based on unusual conditions without 
holding off further data input. To perform the calculations, the high 
priority program segment must initiate a lower priority (interruptable) 
segment to perform the calculations. Since many data handling routines 
would generally be requesting calculations, there will exist a queue of 
calculation jobs waiting to be performed at the software level. Each 
data handling routine must add its job request to the appropriate queue 
(taking care to raise the API priority level as high as the highest 
level that manipulates the queue before adding the request) and issue 
an interrupt request (ISA) at the corresponding software priority level. 

The general flow chart. Figure 5-4, depicts the structure of a software 
handler involved with queued requests. 


Care must be taken about which routines are called when a software 
level request is honored; that is, if a called routine is "open" 
(started but not completed) at a lower level, it must be reentrant or 
errors will result. 


NOTE 

The standard hardware I/O device handlers do not con- 
tain reentrant procedures and must not be reentered 
from higher software levels. 

Resident handlers for Power Fail, Memory Parity, 
nonexistent memory violation, and Memory Protect 
violation have been incorporated into the system 
and effect an lOPS error message if the condition 
is detected (see Appendix E for lOPS errors) . The 
user can, via a .SETUP, tie his own handler to 
these skip lOT or API channel registers (see 5. 1.1.1). 
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LV5 INT 



15-0094 


Figure 5-4 Structure of API Software Level Handler 


5.1.3 Standard API Channel/Priority Assignments 

Option Channel 


Channel 

Device 

Number 

Priority 

Register 

0 

Software Priority 

— 

4 

40 

1 

Software Priority 

— 

5 

41 

2 

Software Priority 

— 

6 

42 

3 

Software Priority 

— 

7 

43 

4 

DECtape 

TC02D 

1 

44 

5 

MAGtape 

TC59D 

1 

45 

6 

RESERVED 

-- 

-- 

46 

7 

RESERVED 

— 

-- 

47 

10 

Paper Tape Reader 

PC15 

2 

50 

11 

Clock Overflow 

KW15 

3 

51 

12 

Power Fail 

KF15 

0 

52 

13 

Parity 

MP15 

0 

53 

14 

Display (LP flag) 

VP15A 

2 

54 

15 

Card Reader 

CR0 3B 

2 

55 

16 

Line Printer 

LP15F/LP15C 

2 

56 

17 

A/D 

AFOl/ADCl/9 

0 

57 

20 

Interprocessor Buffer 

DB99/DB98 

3 

60 

21 

RESERVED 

— 

-- 

61 

22 

Data Phone 

DP09A 

2 

62 

23 

DECdisk 

RF15 

1 

63 

24 

DISK Pack 

RP15 

1 

64 

25 

Plotter 

XY15 

2 

65 

32 

Multi-Station 

LT19A (Tele- 

2 

74 

33 

TTY Control 
Multi-Station 

printer) 

LT19A (Key- 

2 

75 

34 

TTY Control 

DECtape (DCH 

board) 

TC02^ 

1 

76 

35 

Channel 36) 

Dataphone 

DP09A^ 

2 

77 


^Channel allocated for systems with more than one of the above options. 
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5.2 WRITING SPECIAL I/O DEVICE HANDLERS 

This section contains information prepared specifically to aid those 
users who plan to write their own special I/O device handlers for the 
ADVANCED Monitor System. 

The ADVANCED Monitor System is designed to enable users to incorporate 
their own device handlers; however, precautions should be taken when 
writing the handler to ensure compatibility with the Monitor. 

It is assumed that the user is familiar with Section 5.1.1 of this 
chapter. To summarize, the handler is entered via a JMP* from the 
Monitor as a result of a CAL instruction. The contents of the AC con- 
tain the address of the CAL in bits 3 through 17. Bit 0 contains the 
Link, bit 1 contains the Bank/Page Mode status, and bit 2 contains 
the Memory Protect status. The previous contents of the AC and Link 
are lost. 

To show the steps required in writing an I/O device handler, a complete 
handler (Example B) was developed with the aid of a skeleton handler 
(Example A) . This handler is a non-reentrant type (discussed briefly at 
the beginning of this chapter) and uses the Debreak and Restore Instruc- 
tion (DBR) to leave the handler at software priority level 4 or at a 
hardware level for interrupt servicing (if API) , and restore the status 
of the Link, Bank/Page Mode, and Memory Protect. Example A is referenced 
by part numbers to illustrate the development of Example B, a finished 
Analog-to-Digital Converter (ADC) I/O Handler. The ADC handler shown in 
Example B was written for the Type AFOIB Analog to Digital Converter. 

This handler is used to read data from the ADC and store it in the user's 
line buffer. 


The reader, while looking at the skeleton of a specialized handler as 
shown in Example A, should make the following decisions about his own 
handler. (The decisions made in this case are in reference to develop- 
ing the ADC handler) : 


a. Services that are required of the handler (flags, receiv 
ing or sending of data, etc.) - By looking at the ADC lOT ' s 
shown in the Reference Manual, it can be seen that there 
are three lOT instructions to be implemented. These 
instructions are: Skip if Converter Flag Set, Select 

and Convert, and Read Converter Buffer. 

The only service the ADC handler performs is that of 
receiving data and storing it in user specified areas. 

This handler will have a standard 256-word buffer. 

b. Data Modes used (for example, lOPS ASCII, etc.) - Since 
there is only one format of input from the Type AFOIB 
ADC, mode specification is unnecessary in Example C. 

c. Which I/O macros are needed for the handler's specific 
use; that is, .INIT, .CLOSE, .READ, etc. - These are 
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fully described in Chapter 3 of this manual. For an ADC, 
the user would be concerned with four of the macros. 

(1) .INIT would be used to set up the associated API 
channel register and the interrupt skip lOT sequence 
in the Program Interrupt (PIC) ship chain. This is 
done by a CAL (N) as shown in Part III of Example A, 
where (N) is the channel address. The standard 
device/API channel associations can be found in 
Section 5.1.3. 

(2) .READ is used to transfer data from the ADC. When 
the .READ macro is issued, the ADC handler will 
initiate reading of the specified number of data 
words and then return control to the user. The 
analog input data received is in its raw form. It 
is up to the programmer to convert the data to a 
usable format. 

(3) .WAIT detects the availability of the user's buffer 
area and ensures that the I/O transfer is completed. 

It would be used to ensure a complete transfer be- 
fore processing the requested data. 

(4) .WAITR detects the availability of the user's buffer 
area as in (3) above. If the buffer is not avail- 
able, control is returned to a user specified address, 
which allows other processing to continue. 

d. Implementation of the API or PIC interrupt service routine - 
Example A shows an API or PIC interrupt service routine 
that handles interrupts, processes the data and initiates 
new data requests to fully satisfy the .READ macro request. 
Note that the routines in Example A will operate with or 
without API . Example B uses the routines exactly as they 
are shown in Example A. 

During the actual writing of Example B, consideration was 
given to the implementation of the I/O macros in the new 
handler in one of the following ways : 

(1) Execute the function in a manner appropriate to the 
given device as discussed in (c) . .INIT, .READ, 

.WAIT, and .WAITR were implemented into the ADC 
handler (Example B) under the subroutine names 
ADINIT, ADREAD, ADWAIT (.WAIT and .WAITR). 

Wait for completion of previous I/O. (Example B 
shows the setting of the ADUND switch in the 
ADREAD subroutine to indicate I/O underway.) 

(2) Ignore the function if meaningless to the device. 

See Example B (.FSTAT results in JMP ADIGN2) in 
the dispatch table DSPCH. For ignored macros, 
the return address must be incremented in some 
cases , depending upon the number of arguments 
following the CAL (See Chapter 3) . 

(3) Issue an error message in the case where it is 
not possible to perform the I/O function - (An 
example would be trying to execute an .ENTER on 
the paper tape reader.) In Example B, the handler 
jumps to DVERR6 which returns to the Monitor with 
a standard error code in the AC. 


After the handler has been written and assembled, the Monitor must then 
be modified to recognize the new handler. This is accomplished by the 
use of the System Generator Program (SGEN) described in the Utility 
Programs Manual. 
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Once the system has been generated, the system program UPDATE (refer 
to the Utility Programs Manual (DEC-15-YWZA-D) must be used to add the 
new handler to the library. At this time, the user is ready to use 
his specialized device handler in the PDP-15 system. 


5.2.1 Discussion of Example A by Parts 

Part 1 Stores CAL pointer and argument pointer; also picks 
up function code from argument string. 

Part 2 By getting proper function code in Part 1 and add- 
ing a JMP DSPCH , the CAL function is dispatched to 
the proper routine. 

Part 3 This is the .SETUP CAL used to set up the PI skip 
chain and/or the API channel register. Paragraph 
5.1.3 of this manual shows the standard device/API 
associations . 

Part 4 Shows the API and PI handlers. It is suggested 
these be used as shown. 

Part 5 This area reserved for processing interrupt and 
performing any additional I/O. 

Part 6 Interrupt dismiss routine. 

Part 7 Increments argument pointer in bypassing arguments 
of ignored macro CAL ' s . 


5.2.2 Example A, Skeleton I/O Device Handler 



/SKELETON I/O DEVICE HANDLER 
/ 

/CAL ENTRY ROUTINE 
, GLOBL DEV. 

.MED=3 

DEV. DAC DVCALP 
DAC DVARGP 

ISZ DVARGP 

LAC^le DVARGP 

AND C77777 

ISZ DVARGP 

TAD (JMP DSPCH 

DAC DSPCH 

DSPCH XX 

JMP DVINIT 

JMP DVFSAT 

JMP DVSEEK 

JMP DVENTR 

JMP DVCLER 

JMP DVCLOS 

JMP DVMTAP 

JMP DVREAD 

JMP DVWRTE 

JMP DVWAIT 

JMP DVTRAN 


/MUST BE OF FORM AAA. 

/.MED (MONITOR ERROR DIAGNOSTIC) 
/SAVE CAL POINTER 
/AND ARGUMENT POINTER 
/POINTS TO FUNCTION CODE 
/GET CODE 

/REMOVE UNIT NO IF APPLICABLE 
/POINTS TO CAL+2 

/DISPATCH WITH 
/MODIFIED JUMP 
/I = .INIT 

/2 = .FSTAT, .DLETE, .RENAM 

/3 = .SEEK 

/4 = .ENTER 

/5 = .CLEAR 

/6 = .CLOSE 

/7 = .MTAPE 

/10 = .READ 

/II = .WRITE 

/12 = .WAIT 

/13 = .TRAN 


/ILLEGAL FUNCTIONS IN ABOVE TABLE CODED AS; 

JMP DEVERR6 
/FUNCTION CODE ERROR 

DVERR6 LAW 6 /ERROR CODE 6 

JMP* (.MED+1 /TO MONITOR 
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f /DATA MODE ERROR 



DVERR7 

LAW 

7 

/ERROR CODE 7 




JMP* 

(.MED+I 

/TO MONITOR 


Ti 

/DEVICE 

NOT READY 



OJ 

DVERR4 

LAC 

(RETURN 

/RETURN (ADDRESS 

IN HANDLER) 

C 

•H 


DAC* 

(.MED 



J 


LAC 

(4 

/ERROR CODE 4 


o ^ 
a 

1 

JMP* 

(.MED+1 

/TO MONITOR 



/I/O UNDERWAY 

LOOP 



(N 

DVBUSY 

DBR 


/BREAK FROM LEVEL 

4 

PART 


JMP* 

DVCALP 

/LOOP ON CAL 


/NORMAL 

RETURN 

FROM CAL 




DVCK 

DBR 


/BREAK FROM LEVLE 

4 


L 

JMP* 

DVARGP 

/RETURN AFTER CAL 

AND 

1 

r 



/ARGUMENT STRING 



/THE DVINIT ROUTINE MUST INCLUDE 
/A .SETUP CALLING SEQUENCE FOR 
/EACH FLAG CONNECTED TO API 




/AND/OR 

PI A(AT 

S6EN TIME). 


CO 


/THE SETUP CALLING SEQUENCE IS 

• 

# 

H < 


DVINIT 

CAL 

N 

/N = API CHANNEL REGISTER 

ft; ^ 
< 





/(40 -77), N = 0 IF NOT CONNECTED 

P4 





/TO API 




16 


/lOPS FUNCTION CODE 




SKPIOT 


/SKIP lOT TO TEST THE FLAG 




DBVINT 


/ADDRESS OF INTERRUPT 






/HANDLER (PI OR API) 



/THIS SPACE MAY 

BE USED FOR I/O SUBROUTINES 



/INTERRUPT HANDLER FOR API OR 

PI 



DVPIC 

DAC 

DEVAC 

/SAVE AC 




LAC* 

(0 

/SAVEtPC, LINK, BANK/PAGE MODE 




DAC 

DVOUT 

/AND MEMORY PROTECT 




LAC 

DEVION 

/FORCE ION AT DISMISSAL 




JMP 

DVSTON 




DVINT 

JMP 

DEVPIC 

/PI ENTRY 




DAC 

DEVAC 

/API ENTRY; SAVE AC 




LAC 

DEVINT 

/SAVE; PC, LINK, BANK/PAGE MODE 




DAC 

DEVOUT 

/MEMORY PROTECT 

1^ 



lORS 


/CHECK STATUS OF PI 




SMAICLA 


/FOR RESTORATION AT 




LAW 

17740 

/DISMISSAL 




TAD 

DEVION 




DVSTON 

DAC 

DEVSWCH 





DEVCF 


/lOT TO CLEAR aAG 


< 

DEVION 

ION 


/ENABLE PI 


f 

/THIS IS THE AREA DEVOTED TO 

PROCESSING INTERRUPT AND 

LD 

J 


/PERFORMING ANY 

ADDITIONAL I/O 

DESIRED. 

g \ 



lOF 


/DISABLE PI TO INSURE 

^ 1 

CM 



DEVIOT 


/DIMISSAL BEFORE INTERRUPT 


/FROM THIS lOT OCCURS 


5-13 



/INTERRUPT HANDLER DISMISS 

DVDISM LAC 

DEVAC 

DVSWCH XX 


DBR 


JMP^ 

DEVOUT 


ROUTE 

/RESTORE AC 
/ION OR lOF 
/DEBREAK AND RESTORE 
/LINK, BANK/PAGE MODE, 
/PROTECT 


MEMORY 


/IF THE HANDLER USES THE AUTOINCREMENT , INDEX 
/OR EAE REGISTERS, THEIR CONTENTS 
/SHOULD BE SAVED AND RESTORED. FUNCTIONS 
/POSSIBLY IGNORED SHOULD CONTAIN 
/PROPER INDEXING TO BYPASS 
/CAL ARGUMENT STRING 
/ 

/CODE TO BYPASS IGNORED FUNCTIONS 
/ 


DVIGN2 ISZ DVARGP /BYPASS FILE POINTER 

jMp nunv 
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5.2.3 Example B, Special Device Handler for AFOIB A/D Converter. 


PAGE 1 

ADC, 


SRC 





1 

o 





/ADC HANDLDK 
/ 

ADSF5701301 



c 

3 



701301 

A 

/SKIP 

IF conversion FLAG IS SET 

4 



701304 

A 

ADSC=701304 

/SELECT and convert (ADC FLAG IS CLEARED 

5 






/AND A 

CONVERSION IS INITIALISED) 

6 

7 



701312 

A 

AOR8=701312 

/ 

.GLOBU 

/READ 

CONVERTER buffer INTO AC AND CLEAR FLAG 

/ 

8 





A D C , 


9 



440000 

A 

IDX=ISH 



10 



0000,03 

A 

,MED=3 

/MED (MONITOR ERROR DIAGNOSTIC) 

11 





/ 



12 

00000 

R 

040151 

R 

aoc, dac 

adcalp 

/SAVE Cal POINTER 

13 

00001 

R 

040152 

R 

DAC 

adargp 

/and argument pointer 

14 

0'0002 

R 

440152 

R 

lOX 

AOARGP 

/POINTS TO function CODE 

15 

00003 

R 

220152 

R 

LAC« 

adargp 

/GET CODE 

16 

00004 

R 

440152 

R 

lOX 

adargp 

/POINTS TO CAL ♦ 2 

17 

00005 

R 

340155 

R 

TAD 

(JMP DSPCH 

18 

00006 


040007 

R 

DAC 

DSPCH 

/dispatch with 

19 

00007 

R 

740040 

A 

DSPCH XX 


/MODIFIED JUMP 

20 

00010 

R 

600027 

R 

JMP 

adinit 

/!=, INIT 

21 

00011 

R 

600074 

R 

JMP 

ADIGN2 

/2=,FSTaTi .DLETEi .RENAM 

22 

00012 

R' 

600074 

R 

JMP 

ADIGN2 

/3=.SEEk 

23 

, 00013 

R 

600023 

R 

JMP 

A0ERR6 

/4=, enter 

24 

00014 

R 

600023 

R 

JMP 

ADERR6 

/5=, clear 

25 

00015 

R 

600075 

R 

JMP 

aDIGNI 

/6=, CLOSE 

26 

00016 

R 

600075 

R 

JMP 

AOIGNI 

/7=,MTApe 

27 

00017 

R 

600051 

R 

JMP 

aDREAD 

/i0=,read 

28 

00020 

R 

600023 

R 

JMP 

A0ERR6 

/11=iWRitE 

29 

00021 

R 

600044 

R 

JMP 

adwait 

/12= .wait 

30 

00022 

R 

600023 

R 

JMP 

A0ERR6 

/l3= , TRAN 

31 





/ 



32 





/iulegal functions in 

above table coded as 

33 





/ JMP 

ADERR6 


34 





.EJ^CT 
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page 2 ADC. SRC 


ui 


35 

36 


/ 

/FUNCTION CODE ERROR 


37 / 


38 

00023 

R 

760006 

A 

ADERR6 

LAW 

6 

/ERROR code 6 

39 

00024 

R 

620156 

R 


JMP* 

( ,MEO + l 

/TO monitor 

40 





/DATA 

MODE ERROR 


41 

00025 

R 

760007 

A 

ADERR7 

LAW 

7 

/error code 7 

42 

00026 

R 

620156 

R 


JMP* 

( ,MED*1 

/TO monitor 

43 





/THE adint Routine must 

include a .setup 

44 





/for each flag 

ASSOCIATED WITH THE DEVICE 

45 





/ 




46 

00027 

R 

440152 

R 

AOINIT 

IDX 

ADARGP 

/IDX TO return buff SIZE 

47 






.DEC 



48 

00030 

R 

200157 

R 


LAC 

(256 

/standard buffer SIZE (DECIMAu) 

49 






,OCT 



50 

00031 

R 

060152 

R 


DAC* 

AOARCP 

/return it TO USER 

51 

00032 

R 

440152 

R 


IDX 

aoargp 


52 

00033 

R 

000057 

A 

aocmod 

CAL 

57 

/57=API channel 

53 

00034 

R 

000016 

A 

aocksm 

16 


/, setup IOPS FUNCTION CODE 

54 

00035 

R 

701301 

A 

ADCBP 

ads^^' 


/ADC SKIP lOT 

55 

00036 

R 

000104 

R 

adlbhp 

aocint 


/ADDR, OF INTERRUPT 

56 

00037 

R 

200041 

R 

AOUND 

LAC 

.*2 

/SET«UP ONCE ONLY 

57 

00040 

R 

040033 

R 

AOWC 

OAC 

aocmod 

/SKIP Set-up code if more 

58 

00041 

R 

600042 

R 

AOWPCT 

JHP 

ADSTOP 

/.INITS are DONE 

59 





/ 




60 





/STOP 

ADC ROUTINE CLEARS 

1 I/O underway switch 

61 





/ 




62 

00042 

R 

140037 

R 

AOSTOP 

DHM 

AOUND 


63 

00043 

R 

600075 

R 


JMP 

ADIGNI 

/RETURN 


64 

65 

66 

67 

68 

69 

70 

71 

72 

73 

74 

75 


/ 

/THE PREVIOUS TAkS IN THE CAL AreA ARE USED FOR 

/storage during the actual iReao Function 
/ 

/ADCKSM IS FOR STORING THE CHECKSUM 
/ADCBP IS the current BUFFER POInTER 

/adlbhp is The line buffer header pointer 
/AOUND IS for device UNDERWAY SWITCH 
/ADWC IS used as the COUNTER 
/AOWPCT IS USED TO STORE CURRENT WORD COUNT 
/ 

.EJECT 
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ADC, SPC 


76 

00044 

R 

200037 

R 

ADWA IT 

lac 

adund 

77 

00045 

R 

741200 

A 


SNA 


78 

000 4 6 

R 

600075 

R 


JMP 

aoigni 

79 





/I/O underway loop 

80 

00047 

R 

703344 

A 

adbusy 

OBR 


81 

000 50 

R 

620151 

R 


UMP» 

adcalp 

82 





/ 



83 





/ 



84 

0 0 0 51 

R 

200037 

R 

adreao 

LAC 

adund 

85 

00052 

R 

740201 

A 


SZAICMA 


86 

00053 

R 

600047 

R 


JMP 

adbusy 

87 

00054 

R 

040037 

R 


DAC 

ADUND 

88 

00055 

R 

220151 

R 


lac* 

adcalp 

89 

0 0 0 5 6 

R 

500160 

R 


AND 

(7000 

90 

00057 

R 

740200 

A 


SZA 


91 

0 00 6 0 

R 

600025 

R 


JMP 

ADERR7 

92 

00061 

R 

220152 

R 


LAC* 

adargp 

93 

00062 

R 

040035 

R 


OAC 

adcbp 

94 

00063 

R 

040036 

R 


DAC 

aolbhp 

95 

00064 

R 

440152 

R 


lOX 

aoargp 

96 

00065 

R 

220152 

R 


LAC* 

adargp 

97 

00066 

R 

040040 

R 


DAC 

adwc 

98 

00067 

R 

140041 

R 


OZM 

adwpct 

99 

0 0 0 7 0 

R 

140034 

R 


DZM 

ADCkSM 

1G0 

00071 

R 

440035 

R 


IDX 

adcbp 

101 

0 0 0 7 2 

R 

440035 

R 


lOX 

adcbp 

102 








103 

0 0 0 7 3 

R 

701304 

A 


ADSC 


104 

00074 

R 

440152 

R 

ADIGN2 

IDX 

adargp 

105 

0 0 0 75 

R 

703344 

A 

ADIGNl 

DBR 


106 

00075 

R 

620152 

R 


JMP* 

adargp 

107 





/INTERRUPT Handler for 

108 





/ 



109 

00077 

R 

040154 

R 

adcpic 

OAC 

aOCAC 

110 

00100 

R 

220161 

R 


lac* 

(0) 

111 

00101 

R 

040153 

R 


OAC 

ADCOUT 

112 

00102 

R 

200120 

R 


LAC 

ADCION 

113 

00103 

R 

600116 

R 


JMP 

aDSION 

114 






.EJECT 



/CHECK TO SEE IP I/O IS UNDERWAY 

/IF NOT set it with -1 

/IT WAS set, GO BACK TO CAL 

/set IT 

/LOOK At MODE 

/bits 6,8 ONLY 

/lOPs Binary? 

/NO, error 

/get line buffer header pointer 

/STORE IT 

/ALSO Store it for later header 
/increment arc, POINTER 
/get ■'L,B,W,C(2«S COMP) 

/store it in WORD COUNTER 
/2ER0 WORD count REG. 

/zero Checksum reg. 

/get past header pair 

/NOW pointing AT BEGINNING OF 

/BUFFER 

/start up device 

/INCR, for exit 
/break FROM level 4 

/return after cal 
API OR Pic 

/SAVE Ac 

/SAVE PC, link, EX. MODE 
/MEM.PROT, 

/FORCE lON at dismissal 



page: 4 

ADC . 


SRC 






115 

00104 

R 

600077 

R 

adcint 

JMP 

ADCPIC 

/Pic entry 

116 

00105 

R 

040154 

R 


DAC 

adcac 

/API entry, SAVE AC 

117 

00106 

R 

200104 

R 


LAC 

adcint 

/SAVE PC,LINK»EX.M0DE 

118 

00107 

R 

040153 

R 


DAC 

ADCOUT 

/mEm.prot 

119 

00110 

R 

200162 

R 


LAC 

(JMP ADCPlC /RESTORE PIC ENTRY BECAUSE API 

120 

00111 

R 

040104 

R 


DAC 

adcint 

/entry is a JMS, NOT A JUMP 

121 

00112 

R 

700314 

A 


lORS 


/CHECK for pic 

122 

00113 

R 

750100 

A 


SMAJCLA 


/FOR restoration AT 

123 

00114 

R 

777740 

A 


LAW 

17740 

/dismissal (lOF-ION> 

124 

0 0115 

R 

340120 

R 


TAD 

ADCION 

/+ION 

125 

00116 

R 

040146 

R 

aosion 

DAC 

adswch 


126 

00117 

R 

701312 

A 


adrh 


/read Converter buffer 

127 

00120 

R 

700042 

A 

aocion 

I ON 


/enable pIC FOR other DEVICES 

128 

00121 

R 

060035 

R 


DAC<» 

adcbp 

/store data in user buffer 

129 

00122 

R 

440035 

R 


IDX 

adcbp 

/INC, Buffer pointer 

130 

00123 

R 

440041 

R 


lOX 

adwpct 

/INC, Word pair counter 

131 

00124 

R 

340034 

R 


TAD 

adcksm 

/add checksum 

132 

00125 

R 

040034 

R 


DAC 

aocksm 

/store IT 

133 

00126 

R 

440040 

R 


ISZ 

adwc 

/IS I/O complete 

134 

00127 

R 

600143 

R 


JMP 

adcont 

/NO keep going 

135 

00130 

R 

200041 

R 


LAC 

ADWPCT 

/YES, compute word count PAIR 

136 

00131 

R 

740030 

A 


I AC 


/may be oOD 

137 

00132 

R 

742030 

A 


SWHA 


/TO top half 

138 

00133 

R 

740020 

A 


RAR 


/make Wd. PRSi 

139 

00134 

R 

500163 

R 


and 

(377000 

/8 bits only 

140 

00135 

R 

060036 

R 


DAC* 

ADLBHP 

/STORE IN HEADER #1 

l4l 

00136 

R 

440036 

R 


IDX 

adlbhp 

/INC, To store CKSUM 

142 

00137 

R 

340034 

R 


TAD 

aocksm 

/add word pair count 

143 

0014 0 

R 

060036 

R 


DAC* 

ADLBHP 

/STORE IN header #2 

144 

00141 

R 

140037 

R 


DHM 

ADUND 

/CLEAR DEVICE UNDERWAY 

145 

00142 

R 

600145 

R 


JMP 

ADDISM 

/EXIT 

146 

00143 

R 

700002 

A 

adcont 

lOF 


/DISABLE PIC TO ENSURE DISMISSAL 

147 

00144 

R 

701304 

A 


ADSC 


/BEFORE INTERRUPT FROM THIS lOT OCCURS 

148 





/interrupt Handler dismiss rte 

149 





/ 




150 

00145 

R 

200154 

R 

ADDISM 

LAC 

adcac 

/restore AC 

151 






.EJLCT 
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152 00146 R 700042 A ADSWCH ION 

153 00147 R 703344 A DBR 

154 00150 R 620153 R ADCOUT 

155 00151 R 000000 A ADCALP 0 

156 00152 R 000000 A ADARGP 0 

157 00153 R 000000 A aDCOUT 0 

158 00154 R 000000 A ADCAC 0 

159 / 

160 000000 A ,ENU 

00155 R 600007 R 

00156 R 000004 A *L 

00157 R 000400 A 

00160 R 007000 A »L 

00161 R 000000 A 

00162 R 600077 R *L 

00163 R 377000 A *L 

SI2E=00164 NO error LIN^S 


page 6 ADC. SRC 


ADARGP 

00152 R 

ADBUSY 

00047 R 

ADCAC 

00154 

R 

ADCBP 

00035 R 

ADCINT 

00104 R 

AOCION 

00120 

R 

adcmod 

00033 R 

ADCONT 

00143 R 

ADCOUT 

00153 

R 

ADC, 

00000 R 

ADDISM 

00145 R 

A0ERR6 

00023 

R 

ADIGNI 

00075 R 

ADIGN2 

00074 R 

ADINI 1 

00027 

R 

adrb 

701312 A 

ADREAD 

00051 R 

ADSC 

701304 

A 

ADSION 

00116 R 

ADSTOP 

00042 R 

ADSWCH 

00146 

R 

adwait 

00044 R 

ADWC 

00040 R 

ADWPCT 

00041 

R 

IDX 

440000 A 

• MED 

000003 A 




PAGE 

7 ADC. 

SRC 





ADC, 

00000 R 

,MED 

000003 A 

DSPCH 

00007 

R 

ADERR7 

00025 P 

ADINIT 

00027 R 

ADCMOD 

00033 

R 

ADCBP 

00035 R 

ADLBHP 

00036 R 

ADUND 

00037 

R 

ADWPCT 

00041 R 

ADSTOP 

00042 R 

ADWAIT 

00044 

R 

ADREAD 

00051 R 

ADIGN2 

00074 R 

ADIGNl 

00075 

R 

aocint 

00104 R 

ADSION 

00116 R 

AOCION 

00120 

R 

ADDISM 

00145 R 

ADSWCH 

00146 R 

ADCALP 

00151 

R 

ADCOUT 

00153 R 

ADCAC 

00154 R 

lOX 

440000 

A 

ADSC 

701304 A 

ADRB 

701312 A 





/ION OR lOF 

/debreak and restore 

/LINK^EX.M00E»MEM,PR0T 

/add cal Pointer 

/ADD ARGUMENT POINTER 
/PC,L,Fm,MP 

/ac saved here 


ADCAlP 00151 R 
ADCKSM 00034 R 
ADCPIC 00077 R 
ADERR7 00025 R 
ADLBHP 00036 R 
ADSF 701301 A 
ADUND 00037 R 
DSPCH 00007 R 


ADERR6 00023 R 
ADCKSM 00034 R 
ADWC 00040 R 
ADBUSY 00047 R 
ADCPIC 00077 R 
AOCONT 00143 R 
ADARGP 00152 R 
ADSF 701301 A 
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ADC. CROSS reference 


ADARGP 

00152 

13 

14 

15 

16 

46 

50 



96 

104 

106 

156* 



AOBUSY 

00047 

80* 

86 





ADCAC 

00154 

109 

116 

150 

158* 



ADCALP 

00151 

12 

81 

88 

155* 



ADCBP 

00035 

54* 

93 

100 

101 

128 

129 

AOCINT 

00104 

55 

115* 

117 

120 



ADCION 

00120 

112 

124 

127o 




ADCKSM 

00034 

53* 

99 

131 

132 

142 


ADCMOO 

00033 

52* 

57 





ADCONT 

00143 

134 ' 

146* 





ADCOUT 

00153 

111 

118 

154 

157* 



ADCPIC 

00077 

109* 

115 

119 




ADC, 

00000 

8 

12* 





ADDISM 

00145 

145 

1500 





ADERR6 

00023 

23 

24 

28 

30 

38* 


ADERR7 

00025 

41* 

91 





ADIGNI 

00075 

25 

26 

63 

78 

105* 


ADIGN2 

00074 

21 

22 

I04o 




ADINIT 

00027 

20 

46* 





ADLBHP 

00036 

55* 

94 

140 

141 

143 


ADPB 

701312 

6* 

126 





ADREAD 

00051 

27 

84* 





ADSC 

701304 

4* 

103 

147 




ADSF 

701301 

3* 

54 





ADSION 

00116 

113 

125* 





ADSTOP 

00042 

53 

62* 





AOSWCH 

00146 

125 

152* 





ADUND 

00037 

56* 

62 

76 

84 

87 

144 

ADWAIT 

000 4 4 

29 

76* 





ADWC 

00040 

57* 

97 

133 




ADWPCT 

00041 

58* 

98 

130 

135 



OSPCH 

00007 

17 

18 

l9* 




IDX 

440000 

9* 

14 

16 

46 

51 

95 



129 

130 

141 




,med 

000003 

10* 

39 

42 





92 


95 



101 104 



5.3 Device Handlers Acceptable to System Programs 

The following paragraphs provide listings of .DAT Slot assignments for 
the various system programs and the I/O device handlers which may be 
assigned to each. Standard assignments for 8K systems are indicated by 
an asterisk ( *) . 

It is imperative to note that only one I/O handler for a device may be 
in core at the same time Ci-e., PRA and PRB should not be brought in 
together since there is no communication between their interrupt 
handling routines) . 


5.3.1 FORTRAN IV (F4) 


-11 


-12 


-13 


Use 

Handler 

Input 

TTA 

PRA 



*PRB 



CDB 

DTA, 

DKA 


DTB, 

DKB 


DTC, 

DKC 


DTD, 

DKD 


DTE, 

DKE 


DTF, 

DKF 

Listing 

*TTA 



LPA 

VPA 

PPA 

DTA, 

DKA 


DTB, 

DKB 


DTD, 

DKD 


DTE, 

DKE 


DTF, 

DKF 

Output 

PPA 

PPB 



*PPC 



DTA, 

DKA 


DTB, 

DKB 


DTD, 

DKD 


DTE, 

DKE 


DTF, 

DKF 


, MTA (for 3 open files) 
(for 2 open files) 

, MTC (1 input file only) 

y (1 file only) 

, MTF (non-file-oriented) 


y (1 file only) 


(for 2 open files) 
y (1 file only) 

MTF (non-file-oriented) 


5.3.2 MACRO-15 


.DAT Slot Use 


Handler 


■11 


Input 


TTA 

PRA 

*PRB 

CDB 


CDB 

DTA, DKA, MTA (for 3 open files) 
1 (1 file only) 
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5.3.2 (Cont . ) 


5.3.3 FOCAL 


.DAT Slot 

Use 

Handler 





-10 

Parameter 

TTA 







File 

*PRA 







Input 

PRB 

(recommended) 





CDB 

DTA, 

DKA, 

MTA 

(for 

3 open 

files) 



DTD, 

DTE, 

DKD 

DKE 

) 

file 

only) 


-14 

Macro Def- 

TTA 







initions 

PRA 







File 

PRB 

CDB 

*DTA, 

DKA, 

MTA 

(for 

3 open 

files) 



DTD, 

DTE, 

DKD 

DKE 

1 — 1 

file 

only) 


-12 

Listing 

*TTA 







Output 

LPA 

VPA 

PPA 

DTA, 

DKA, 

MTA 

( for 

3 open 

files) 



DTD, 

DTE, 

DKD 

DKE 

1 — 1 

file 

only) 


-13 

Output 

PPA 

PPB 

*PPB 







DAT Slot Use 


Handler 


3 


Library 

TTA 



Input 

PRA 

PRB 

CDB 

*DTA, 

DKA, 

MTA (for 3 open files) 


DTC, 

DKC, 

MTC (1 input file only) 


DTD, 

DKD 

(1 file only) 


DTE, 

DKE 

(recommended - 1 file only) 


5 


Library 

TTA 




Output 

PPA 

DTA, 

DKA, 

MTA (for 3 open 

files) 


DTD, 

DKD 

(1 file only) 



DTE, 

LPA 

VPA 

DKE 

(recommended - 1 

file only) 


5-22 



5.3.3 (Cont.) 


.DAT Slot 

Use 

Handler 



7 

Data 

File 

Input 

TTA 

PRA 

PRB 

CDB 

*DTA, DKA, 

DTC, DKC/ 

DTD, DKD 

DTE, DKE 

MTA (for 3 open files) 
MTC (1 input file only) 
(1 file only) 
(recommended - 1 file on 

10 

Data 

File 

Output 

TTA 

PPA 

*DTA, DKA, 

DTD, DKD 

DTE, DKE 
LPA 

VPA 

MTA (for 3 open 
(1 file only) 
(recommended - 1 

files) 

file) 

EDIT and EDITVP 





.DAT Slot 

Use 

Handler 



-15 

Scratch/ 

Output 

TTA 

VPA 

LPA 

PPA 

*DTA, DKA, 

DTD, DKD 

DTE, DKE 

MTA (required for 
and output 

^ (1 file only) 

input 

-14 

Input 

TTA 

PRA 

PRB 

CDB 

*DTA, DKA, 

DTD, DKD 

DTE , DKE 

MTA (required for 
and output) 

^ (1 file only) 

input 

-10 

Second- 

ary 

Input 

TTA 

*PRA 

PRB (recommended) 

CDB 


10 

Display 

Output 

(EDITVP 

VPA 





5.3.5 Linking Loader and DDT 


.DAT Slot Use 


Handler 


-1 


System 

Library 

PRA 

DTA, 

DKA 

(for 3 open 

user files) 

Input 

DTB, 

DKB 

(for 2 open 

user files) 


*DTC, 

DKC 

(1 input file only - 


DTD, 

DTE, 

DKD 

DKE 

recommended 

if no user I/o) 


-4 


-5 


User 

Program 

Input 


External 
User 
Library 
Input J 


Same as specified above 
.DAT Slot -1. 


for 


NOTE 

Since Linking Loader handlers can be used by 
the program being loaded, choice of bulk 
storage handlers should be made in terms of 
user requirements. 


5.3.6 PIP (Peripheral Interchange Program) 

PIP uses all the positive .DAT Slots (1 through 10) plus -2 and -3 for 
TTY f/0. Prior to use, any non-standard device assignments should be 
made via the ASSIGN command to the Monitor. If several functions are 
to be used with a variety of peripherals, assignment of these devices 
all at the same time avoids the necessity for returning to the Monitor 
to reassign devices and for repeatedly reloading PIP after each 
operation that requires a new device. Conversely, it may be necessary 
to clear certain unused .DAT Slots (i.e., ASSIGN NONE n, n,...,etc.) 
to prevent loading of standardly assigned handlers. This is particu- 
larly useful when operating in SK with non-standard handlers the size 
of which, in combination with other standard handlers, could cause core 
overflow during loading of PIP (.SYSLD 1 error). 


NOTE 

The device handlers used with PIP should normally be 
those having the greatest capability (i.e., PRA, PPA, 
DTA, DKA, etc.) . If both input and output are to occur 
on the same device (e.g., DECtape) , separate .DAT 
Slots must be assigned- Both .DAT Slots must be 
assigned to the same handler; otherwise erroneous 
results will occur since there is no communication 
between the interrupt service routines of different 
handlers (e.g. DTA assigned to one. DAT Slot and 
DTB assigned to another) . 
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PIP standard (8K) assignments are as follows: 


5.3.7 


5.3.8 


5.3.9 


.DAT Slot Use Handler 


1 

I/O 

*DTA 

2 

I/O 

*DTA 

3 

I/O 

*DTA 

4 

I/O 

*TTA 

5 

Input 

*PRA 

6 

Output 

*PPA 

7 

I/O 

*DTA 

10 

I/O 

*DTA 

SGEN (System Generator) 


.DAT Slot 

Use 

Handler 

-15 

Output 

*DTA, DKA 

-14 

Input 

*DTA, DKA 

PATCH 



.DAT Slot 

Use 

Handler 

-10 

Second- 

ary 

Input 

*PRA 

DTA, DKA 

-14 

I/O 

*DTA, DKA 

DTD, DKD 

DTE , DKE 

UPDATE 



.DAT Slot 

Use 

Handler 


-14 

Input 

PRA 

*DTA, 

DKA, 

MTA 

-15 

Output 

PPA 

PPB 

PPC 

*DTA, 

DKA, 

MTA 

-10 

Second- 

*PRA 




ary 

Input 

DTA, 

DKA, 

MTA 

-12 

Listing 

LPA 

*TTA 





VPA 

PPA 

DTA, 

DKA, 

MTA 
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5.3.10 DUMP 


5.3.11 


5.3.12 


DAT Slot Use 


Handler 


-14 


-12 


Input 


Listing 


*DTA, DKA, MTA 

DTD, DKD 

DTE, DKE 

*TTA 

LPA 

VPA 

PPA 

DTA, DKA, MTA 

DTD , DKD 

DTE, DKE 


CHAIN 


.DAT Slot 


Use 


Handler 


-4 


-1 


-5 


Input 


System 

Library 

User 

Library 


PRA 



DTA, 

DKA, MTA 


DTB, 

DKB (recommended) 

*DTC, 

DKC , MTC '' 

\ CUse only if no 

DTD, 

DKD 

/other DT, DK, or 

DTE, 

DKE 

' MT is assigned) 


Same as for .DAT -4 


NOTE 

Use the smallest handlers possible since they 
are not recoverable as user handlers (i.e., in 
the overlay system) . 


EXECUTE 


DAT Slot 


Use 


Handler 


-4 CHAIN-Built 

Overlay Sys- 
tem Input 
(XCT, XCU 
Files) 


PRA 

DTA, DKA, MTA 

DTB, DKB 

*DTC, DKC, MTC (use only if not shared 
with overlay system) 

DTD, DKD 

DTE, DKE 
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5.3.13 SRCCOM (Source Compare) 


DAT Slot 

Use 

Handler 



-15 

Old File 

TTA (if not assigned 

to 

-14) 


Input 

PRA (if not assigned 

to 

-14) 



CDB (if not assigned 
*DTA, DKA, MTA 

to 

-14) 



DTD, DKD 

DTE, DKE 



-14 

New File 

TTA (if not assigned 

to 

-15) 


Input 

PRA (if not assigned 

to 

-15) 



CDB (if not assigned 
*DTA, DKA, MTA 

to 

-15) 



DTD, DKD 

DTE, DKE 



-12 

Listing 

*TTA 




PPA 

LPA 

VPA 


DTA, DKA, MTA 

DTD, DKD 

DTE , DKE 


5.3.14 DTCOPY (DECtape Copy) 


.DAT Slot 

Use 

Handler 

-14 

Input 

*DTA, 

DKA 



DTD, 

DKD 



DTE, 

DKE 

-15 

Output 

*DTA, 

DKA 



DTD, 

DKD 



DTE, 

DKE 


5.3.15 8TRAN (PDP-8 to PDP-15 Translator) 


DAT Slot 

use 

Handler 


-15 

Input 

PRA 

CDB 

TTA 

*DTA, 

DKA, 

MTA 



DTD, 

DKD 




DTE, 

DKE 


-14 

Output 

PPA 

LPA 

TTA 

VPA 

*DTA, 

DKA, 

MTA 



DTD, 

DKD 




DTE, 

DKE 
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5.4 SUMMARY OF STANDARD I/O HANDLER FEATURES 

5.4.1 TTA. (Teletypewriter) 

5. 4. 1.1 General Description - TTA. (469^^ registers) is embedded in 
the Resident Monitor and provides all necessary functions for teletype- 
writer I/O. All functions (described below), except .READ and .WRITE, 
refer to action taken when either the teleprinter or the keyboard is 
addressed. 


5. 4. 1.2 Functions 


Mnemonic 


Code 


Action 


. INIT 


Return standard buffer size (34^^) 

Assign return address for certain 
control characters (CTRL C, CTRL T, 
CTRL P) from contents of CAL 
ADDRESS+2 . Bits 0 and 1 in 
CAL+2 are set to designate caller: 

Bit 0-1 Caller 

01 Monitor (fC) 

10 DDT (IT) 

00 All others (fp) 

c. Set I/O UNDERWAY indicator 

d. Print Carriage RETURN/LINE FEED 
(CR/LF) 



. DLETE 

. RENAM 

.FSTAT 

.SEEK 

.ENTER 

. CLEAR 

.CLOSE 



.MTAPE 7 

.READ 10 

.WRITE 11 

.WAIT, .WAITR 12 


.TRAN 


13 


Ignored 

a. Set I/O UNDERWAY indicator 

b. Print CR/LF 

c. Wait for completion of I/O. 
Ignored 

a. Set I/O UNDERWAY indicator 

b. Set up to accept characters 
from keyboard 

a. Set I/O UNDERWAY indicator 

b. Print 

Test for I/O UNDERWAY 

(1) If busy, return to CAL (.WAIT) 
or to address in CAL+2 (.WAITR) 

(2) If non-busy, return to CAL+2 
(.WAIT) or to CAL+3 (.WAITR) 

Illegal function lOPS 6 
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5. 4. 1.3 


Legal Data Modes 


lOPS ASCII (Mode 2) 

Image Alphanumeric (Mode 3) 


5. 4. 1.4 Function Characters - The following function characters may 
have special significance v/hen input or output in lOPS ASCII Mode. In 
Image Alphanumeric Mode, these characters are treated as ordinary ASCII. 

Transfer 

Character Direction Action 


Carriage RETURN (015g) Input 

Output 

ALT MODE (175 _) Input 

O 

Output 


Insert in the user's buffer 

Output Carriage RETURN/LINE FEED 
operation (015/012) 

Accept 33,175 or 176 and map into 
user's buffer as 175 

Output Carriage RETURN/LINE FEED 


FORM Feed (014^) 
or 

VT (Vertical Tab) (Oll^) 

O 

Horizontal TAB (Oil ) 

O 

RUBOUT (177g) Input 

Output 

LINE FEED (012g) Input 

Output 

CTRL U (025g) Input 

Output 

Null (OOOg) Input/Output 


Input 

Output 

Input 

Output 


Insert in user's buffer, as applicable 
Output FORM Feed function 

Insert in user's buffer 

Model 35 - Output (Ollg) TAB function 

Model 33 - Output sufficient number 
of spaces (040g) to posi- 
tion the printer at column 
9,17,25 , ... ,70. 

Delete previous character typed and 
echo a reverse slash (\) . 

Ignore 

Insert in user's buffer 

Ignore all leading LINE FEEDs and 
output all others. 

Delete all characters typed since 
last Carriage RETURN, and echo a 
commercial at (@) sign. If output 
is underway, terminate printing and 
output a Carriage RETURN/LINE FEED 
operation . 

Ignore 

Ignore 


5. 4. 1.5 Program Control Characters - The following Program Control 
Characters, regardless of mode of operation or of transfer direction, 
are recognized when typed on the keyboard. The current I/O function is 
stopped and the character is decoded as described below^ : 


^Character will be ignored (no echo) for CTRL C, P and T if respective 
.INIT has not been performed. 
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Character 


Action 


CTRL C (echoes fC) 

CTRL P (echoes +P) 

CTRL T (echoes fT) 

CTRL S (echoes fS) 
CTRL Q (echoes tQ) 


Transfer control to the address specified 
as return in the .INIT (to the TTY) per- 
formed by the Monitor. 

Transfer control to the address specified 
as return in the .INIT (to the TTY) per- 
formed by the user (other than Monitor 
or DDT) . 

Transfer control to the address specified 
as return in the .INIT (to the TTY) 
performed by DDT. 

Transfer control to the aiddress specified 
in .SCOM+6 (location 106 g in the Monitor) 

Transfer control to Monitor Save routine 
(KM9SAV) . 


5. 4. 1.6 Unrecoverable Errors (No Program Initiated Recovery) 


a. Illegal Data Mode - lOPS 7 

b. Illegal Function - lOPS 6 

5. 4. 1.7 Restriction - TTY I/O can only be requested from mainstream 
in API systems, since the teleprinter is not connected to the API. 


5.4.2 PP (Paper Tape Punch) 

5. 4. 2.1 General Description - Three handlers are provided for use with 
the Paper Tape Punch. PPA registers) is the most general and 

operates in all data modes. PPB (270^^ registers) accepts data in all 
modes except lOPS ASCII. PPC (210^^ registers) accepts lOPS Binary 
only. 


:.2 Functions 




Mnemonic 

Code 


Action 

. INIT 

1 

a. Return 

standard buffer size (52^^). 



b. .SETUP 

- no API. 



c. Punch 

two fanfolds of leader. 

.DLETE ^ 




.RENAM > 

2 

Ignore 


.FSTAT J 




.SEEK 

3 

Illegal function (lOPS 6) 

.ENTER 

4 

Ignore 


. CLEAR 

5 

Ignore 


. CLOSE 

6 

a. Allow 

previous output to terminate. 



b. Punch 

EOF if lOPS Binary. 



c . Punch 

two fanfolds of trailer. 



d. Allow 

trailer punching to terminate. 
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Paper Tape Punch - Functions (Cont.) 


Mnemonic 

Code 

Action 

. MTAPE 

7 

Ignore 

.READ 

10 

Illegal function (lOPS 6) 

.WRITE 

11 

a. Allow previous output 



b. Output buffer. 

.WAIT, 

•WAITR 12 

Check I/O underway 


(1) Busy? Return to CAL (.WAIT) or to 
address in CAL+2 (.WAITR) 

(2) Non-busy: Return to CAL+2 (.WAIT) 
or to CAL+3 (.WAITR). 

.TRAN 13 Illegal function (lOPS 6) 

5.4.2. 3 Legal Data Modes 

a. lOPS Binary (Mode 0) PPA. , PPB. , PPC. 

b. IMAGE Bina:^y (Mode 1) PPA. , PPB. 

c. lOPS ASCII (Mode 2) PPA. 

d. IMAGE Alphanumeric (Mode 3) PPA., PPB. 

e. Dump (Mode 4) PPA., PPB. 

5. 4. 2. 4 Vertical Control Characters (lOPS ASCII only) - May appear as 
only first character of line and will be ignored if elsewhere in line; 
if no vertical control character at beginning of line, a line feed 
(012g) will be used. 

a. LINE FEED (012g) - Output 

b. VT (Vertical Tab 013g) - Output, followed by four RUBOUTs (177g) 

c. FORM Feed (014g) - Output, followed by 40g Nulls (OOOg) 

5. 4. 2. 5 Horizontal Control Characters (lOPS ASCII only) 

TAB (Ollg) - Output followed by one RUBOUT (177g) 

5. 4. 2. 6 Recoverable Errors 

No tape in punch Monitor error lOPS 4 

a. Put tape in punch 

b . Type CTRL R 
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a. Illegal function Monitor error lOPS 6 

a. .SEEK 

b . . READ 

c. .TRAN 

b. Illegal data mode Monitor error lOPS 7 

5.4.2. 8 Restriction - In API systems, the Paper Tape Punch can be 
called only from mainstream, since the punch is not connected to the 

API. 

5.4.3 PR (Paper Tape Reader) 

5.4. 3.1 General Description - Two handlers are provided for use with 

the Paper Tape Reader. PRA, registers) operates in all data 

modes, while PRB. (294^^^ registers) accepts lOPS ASCII only. 

5. 4. 3. 2 Functions 


Mnemonic Code 


Action 


.INIT 1 a. Return standard line buffer size 

( 52 ^ 0 > 

b. .SETUP API channel register 50 g 

c. Clear I/O UNDERWAY indicator 

2 Ignore 

3 Ignore 

4 Illegal function (lOPS 6) 

5 Illegal function (lOPS 6) 

6 Allow previous input to finish and then 
clear I/O UNDERWAY indicator. 

7 Ignore 

10 a. Allow previous input to be completed. 

b. Input line or block of data (see 
modes below) . 

.WRITE 11 Illegal function (lOPS 6) . 

.WAIT, .WAITR 12 Check I/O underway 

(1) Busy: Return to CAL (.WAIT) or to 
address in CAL4-2 (.WAITR) 

(2) Non-busy: Return to CAL+2 (.WAIT) 

or to CAL+3 (.WAITR) 

.TRAN 13 Illegal function (lOPS 6) 


. DLETE 
. RENAM 
.FSTAT 
.SEEK 
.ENTER 
. CLEAR 
. CLOSE 

. MTAPE 
. READ 
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5. 4. 3. 3 Legal Data Modes 


a. lOPS ASCII (Mode 2) 
PRA. , PRB. 


(1) Constructs line buffer header, computing 

(a) Word pair count 

(b) Data mode 

(c) Data validity bits 

(2) Packs characters into the line buffer 
in 5/7 ASCII, checking parity (eighth 
bit, even) , on each character. 

(3) Allows vertical form control characters. 
(FF, LF, VT) only in character position 
1 of the line buffer. Otherwise, 
ignored. 

(4) Terminates reading on CR or line buffer 
overflow. In the latter case, tape is 
moved past the next CR to be encountered 


b. lOPS Binary (Mode 0) 
PRA. 


(1) Reads binary data in alphanumeric mode, 
checking parity (seventh hole, odd) on 
each frame. 


(2) Accepts line buffer header at head of 
input data, modifying data validity 
bits if parity or checksum error (or 
short line) have occurred. 

(3) Terminates reading on overflow of word 
pair count in line buffer header or 
word count in .READ macro, whichever is 
smaller, moving tape to end of line or 
block if necessary. 


c. Image Alphanumeric 
(Mode 3) PRA. 


(1) Constructs line buffer header, computing 

(a) Word pair count 

(b) Data mode 

(2) Stores characters, without editing, or 
parity checking in the line buffer, one 
per register. 

(3) Terminates reading as a function of 
.READ macro word count. 


d. 


Image Binary (Mode 1) 
PRA. 


Same as Image Alphanumeric; however a binary 
read is issued to the PTR. 


e. Dump (Mode 4) PRA. Same as Image Alphanumeric except a binary 

read is issued to the PTR. No header is 
constructed; loading begins at the core 
address specified in the .READ macro. 


NOTE 

An end-of-tape condition causes the PTR 
interrupt service routine to terminate 
the input line, turning off the I/O 
UNDERWAY program indicator and marking 
the header (data mode bits) as an EOM 
(end-of-medium) for all modes except 
Dump . 
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5.4. 3.4 Unrecoverable Errors 

a. Illegal function Monitor error lOPS 6 

(1) .ENTER 

( 2 ) . CLEAR 

(3) .WRITE 

(4) .TRAN 

b. Illegal Data Mode Monitor error lOPS 7 

5.4.4 DT (DECtape) 

5. 4. 4.1 General Description - Six handlers are available for DECtape 
operations . 

DTA. (2296^q registers) is the most general DECtape handler issued with 
the ADVANCED Software System. DTA. has a simultaneous 3-file capacity, 
either input or output. Files may be referenced on the same or differ- 
ent DECtape units, except that two or more output files may not be on 
the same unit. All data modes are handled as well as all lOPS func- 
tions except .MTAPE. Three 256^Q-word data buffers, three 3 2 -word 
Directory Bit Maps, and three 32^Q-word File Bit Maps are included in 
the body of the handler. 

DTB. (1554j^q registers) has a simultaneous 2-file capacity, one input 
and one output. Both files may be on the same or different units. 

DTB. transfers data only in lOPS ASCII or lOPS Binary Data modes. In- 
cluded in the handler is space for two 256^Q-word buffers, one 32^^- 
word Directory Bit Map, and one 32j^Q-word File Bit Map. Functions 
included are: .INIT, .ENTER, .READ, .WAIT, .WAITR, .SEEK, .CLOSE, and 
. WRITE . 

DTC. (6 89j^q registers) is the most limited (and conservative in terms 
of core allocation) DECtape handler in the ADVANCED Software System. 

DTC. is a READ ONLY handler with a 1-file capacity requiring no space 
for bit maps and only one 256j^Q-word DECtape buffer to handle either 
lOPS ASCII or lOPS Binary input (and no other) . Functions included are 
.INIT, .SEEK, .CLOSE, .READ, .WAIT, .WAITR. 

DTD. (1593^q registers) has full lOPS function capabilities including 
.MTAPE commands (REWIND, BACKSPACE) . It allows for only one file refer 
ence, either input or output, at any given time. Sequential file refer 
ences are permitted. All data modes are acceptable to DTD. . One 256^^ 
word data buffer, one 32^Q-word Directory Bit Map, and one 32^Q-word 
File Bit Map are included. 

DTE. (1468^q registers) has the same capabilities as DTD. except the 
.MTAPE function is not allowed. 

DTP. ^^U^sters) is a non-file-oriented, multi-unit handler which 

will accommodate (serially) up to eight DECtape units, both input and 
output. When the last block on a tape has been accessed, lOPS 4 will 
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be typed. The user may continue onto another tape simply by dismounting 
the current tape, replacing it with another, and typing CTRL R. If the 
tape is not replaced at this time, and CTRL R is typed, the contents 
of this tape will be lost if a .WRITE operation is being performed. 

The handler accepts lOPS ASCII and Binary with no internal buffering. 
Legal functions are as follows: .CLOSE, .READ, .WRITE, .MTAPE, .INIT, 
.WAIT, .WAITR. 

5. 4. 4. 2 Functions 


Mnemonic Code Action 

.INIT 1 a. Return standard line buffer size (255^^^) 

b. .SETUP - API channel register 44 „ 

O 

c. Set direction switch (input or output) 
NOTE 

In order to change transfer direction when operating 
in a file oriented environment, a new .INIT must 
first be executed. 

a . . DLETE 

2 (1) Examines specified Directory for 

presence of desired file name. 

If not found, AC=0 upon return 
to user. 

(2) Deletes file name (clears to 0) 
from the Directory of the 
specified unit. 

(3) Clears file bit map corresponding 
to deleted entry. 

(4) Clears corresponding occupancy 
bits in Directory bit map. 

(5) Records modified Directory and 
file bit map block on specified 
unit. 

b . . RENAM 

(1) Examines specified Directory for 
presence of desired file name. 

If not found, AC = 0 upon return 
to user. 

(2) Changes file name in Directory 
to new one specified by user 
program (no change is made to 
first block pointers) . 

(3) Records modified Directory on 
specified unit. 

c. .FSTAT examines specified Directory for 
presence of desired file name. If not 
found, AC = 0 upon return to user. If 
found, AC = first block number of file. 
Also, bits 0 - 2 of CAL ADDRESS + 2 = 

1 = DECtape Directory type. 
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DECtape Functions (Cont.) 


Mnemonic 


Code 


Action 


.SEEK 


.ENTER 


. CLEAR 


. CLOSE 


3 


4 


5 


6 


a. Loads into core the Directory of the 
unit specified if the Directory is 
not already in core. 

b. Checks for presence of named file. 
(Error return to Monitor if not 
found . ) 

c. Begins transfer of first block of 
file into handler buffer area, over- 
laying Directory Entry Section but 
not Directory Bit Map. 

d. Declares unit to be file oriented. 

a. Loads into core the Directory of the 
unit specified if the Directory is 
not already in core. 

b. Checks for presence of named file. 

If present, pointer to that entry 
is saved for update at .CLOSE time. 

If not present, empty slot is found 
for file name insertion at .CLOSE 
time . 

c. Examines Directory Bit Map for free 
block and saves that block nimber 
for first transfer out and for 
insertion in Directory Entry Section 
at .CLOSE time. 

d. Declares unit to be file oriented. 

a. Zeroes out File Bit Map blocks 71 
through 77 on specified DECtape unit. 

b. Initializes DECtape Directory block 
100 to indicate that eight blocks 
(71 through 100) are occupied. 

a. File-oriented Operation 

(1) On input, clears Internal program 
switches. On output, writes 
2-cell EOF line as last line 

in output buffer (lOPS ASCII 
and Binary only) and outputs last 
data buffer with the data link = 
777777. 

(2) Loads into core the File Bit Map 
corresponding to the Directory 
Entry in order to clear the 
Directory Bit Map of bits for 
blocks formerly occupied by this 
file. 

(3) Records newly constructed File Bit 
Map . 

(4) Loads Directory into memory, 
enters new entry and records 
Directory again with new entry 
and updated Directory Bit Map. 

(5) Clears internal program switches. 
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DECtape Functions (Cont.) 


Mnemonic 


. MTAPE 


.READ 


.WRITE 


. WAIT , 
.WAITR 


.TRAN 


Code Action 

b. Non-file-oriented Operation (DTD. and 
DTE. only) 

During output, a three word EOF 
block is written as the last DECtape 
block of the logical record, as 
follows : 

001005 

776773 

000000 

The remaining words of the EOF DECtape 
block are zero. 


7 


10 


11 


12 


13 


a. Rewind 

(1) Sets internal switches such that 
data transfer will begin at block 
0 in the forward direction. 

(2) Declares the unit to be non-file- 
oriented (i.e., data will be 
recorded, beginning at block 0, 
and continuing every fifth block 
thereafter) . V7hen EOT is reached, 
recording continues in the reverse 
direction. Five passes are required 
to record the entire tape (IIOOq 
blocks) . 

b. Backspace - Decrements the internal 
block pointer to the next block to 
be transferred. 

c. Space Forward One Record - The block 
pointer is incremented by 5 (no 
physical action) . 

d. Other .MTAPE functions ignored. 

a. Inputs line from DECtape handler buffer 
or block of data to user area. (See 

5. 4. 4. 3 for data modes.) 

b. Initiates input of next DECtape block 
when preceding block has been emptied. 

a. Transfers line or block of data from 
user area to DECtape handler buffer. 

b. Outputs buffer when full, examining 
Directory Bit Map for free block 
number to store as Data Line (word 
377g) of current block output. 

Checks I/O underway 

(1) Busy; Return to CAL (.WAIT) or to 
address in CAL + 2 (.WAITR) 

(2) Non-busy: Return to CAL + 2 (.WAIT) 
or to CAL + 3 (.WAITR) 

Transfers (in or out) the number of words 
specified by the user's word count to/from 
the core area indicated in the .TRAN macro 
to/from the specific block (s) desired by 
the user. Data will be transferred to/from 
contiguous DECtape blocks in the forward 
or reverse direction (also declared by the 
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DECtape Functions (Cont.) 


Mnemonic Code Action 

user) . On input, transfer stops on word 
count overflow; however, if the word count 
is not equivalent to an integral number of 
DECtape blocks, the remainder of the last 
block will be filled with zeros. 


5. 4. 4. 3 Legal Data Modes 

lOPS ASCII (Mode 2) DTA. , DTB., DTC., DTD., DTE., DTF. 
lOPS Binary (Mode 0) DTA., DTB., DTC., DTD., DTE., DTF. 
Image Alphanumeric (Mode 3) DTA., DTD., DTE. 

Image Binary (Mode 1) DTA., DTD., DTE. 

Dump (Mode 4) DTA., DTD., DTE. 


5. 4. 4. 4 Recoverable Errors 


Select Error^ Monitor Error lOPS 4 

a. Ready the desired DECtape unit 

b . Type CTRL R on the TTY . 


5. 4. 4. 5 Unrecoverable Errors 

a. Illegal Function Monitor Error lOPS 6 

See 5. 4. 4.1 for legal functions for 
each DT handler. 

b. Illegal Data Mode Monitor Error lOPS 7 

(1) .SEEK with .INIT for output. 

(2) .ENTER with .INIT for input. 

(3) See 5. 4. 4.1 for .READ, .WRITE legal 
data modes . 

c. File Still Active Monitor Error lOPS 10 

.SEEK, .ENTER, .CLEAR or .OPER when last 
file has not been closed. 

d. .SEEK, .ENTER Monitor Error lOPS 11 

Not Executed .READ or .WRITE executed prior to .SEEK 

or .ENTER (or . MTAPE-REWIND) 

e. DECtape Error Monitor Error lOPS 12 

(1) Mark Track Error 

(2) EOT during read or write 

f. File Not Found Monitor Error lOPS 13 

File name not found in Directory on a 
.SEEK 

g. DECtape Directory Monitor Error lOPS 14 

Full Directory Entry Section found full on 

an .ENTER 


^A "Select" error is equivalent to a hardware not ready condition. 
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Unrecoverable Errors (Cont. ) 


h. 

DECtape Full 

Monitor Error lOPS 15 

All DECtape blocks occupied on a 
.WRITE or .ENTER 

i . 

Output Buffer 
Overflow 

Monitor Error lOPS 16 

(1) Output line (lOPS ASCII or Binary) 
greater than 255,^ cells (including 
header) . 



(2) Output block (Image Binary or Image 
Alphanumeric) greater than 255, ^ 
cells (excluding header) . 

j • 

Excessive Number of 
Files Referenced 

Monitor Error lOPS 17 

See 5. 4. 4.1 for file reference limitations. 

k. 

Two output files 
on same unit 

Monitor Error lOPS 22 

Two output files open simultaneously 
on the same unit 

1. 

Illegal Word Pair 
Count (WPC 

Monitor Error lOPS 23 

WPC = 0 , or greater than 177 

5.4.5 

RF (RF15 DECdisk) 



The following naming convention is observed with the handlers described 

below. Although the RF15 handlers are named RFA. , RFB . , etc., the 

\ 

system software expects handler names such as: DKA. , DKB., etc. There- 
fore, the . GLOBL name given in these handlers is DKn. All user refer- 
ences must be to DK rather than RF. 

5. 4.5.1 General Description - The following six handlers are provided 
for DECdisk operation. 

RFA. (2269^q registers) is the most general Disk handler for the RF/RS 
Disk issued with the ADVANCED Software System. RFA. has a simultaneous 
3-file capacity, either input or output. Files may be referenced on 
the same or different Disk units, except that two or more output files 
may not be on the same unit. All Data Modes are handled as well as 
all lOPS functions except .MTAPE. Three 256^Q-word data buffers, three 
32io-word Directory Bit Maps, and three 32^Q-word File Bit Maps are 
included in the body of the handler. 

RFB. (1536^q registers) has a simultaneous 2-file capacity, one input 
and one output. Both files may be on the same or different units. RFB. 
transfers data only in lOPS ASCII or lOPS Binary Data Modes . Included 
in the handler is space for two 256^Q-word data buffers, one 32^Q-word 
Directory Bit Map, and one 32j^Q-word File Bit Map. Functions included 
are: 

.INIT .ENTER .READ .WAIT, .WAITR 

•SEEK .CLOSE .WRITE 
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RFC. (655 registers) is the most limited (and conservative in terms 
of core allocation) Disk handler in the ADVANCED Software System. RFC. 
is a read-only handler with a 1-file capacity requiring no space for 
Bit Maps and only one 256^Q-word data buffer to handle either lOPS ASCII 
or lOPS Binary input (and no other). Functions included are: 

.INIT .CLOSE .WAIT, .WAITR 

. SEEK . READ 

RFD. (1517^q registers) has full lOPS function capabilities including 
.MTAPE commands (REWIND, BACKSPACE) . It allows for only one file 
reference, either input or output, at any given time. Sequential 
file references are permitted. All data modes are acceptable to RFD. . 
One 256^Q-word data buffer, one 32^Q-word Directory Bit Map, and one 
32gio)-word File Bit Map are included. 

RFE . (1436^q registers) is the same as RFD. except that it will not 
handle .MTAPE commands. 

RFF. (553^q registers) is a non-file-oriented, multi-unit handler which 
will accommodate (serially) up to four RF15 DECdisk platters (eight 
logical units) , both input and output. When either the last block 
(forward direction) or first block (backspacing) of a unit has been 
accessed, an lOPS 4 message will be typed. The user may continue onto 
the next sequential (higher or lower) disk unit by typing CTRL R. The 
handler accepts both lOPS ASCII and Binary with no internal buffering. 
Legal functions are as follows: 

.READ .WRITE .MTAPE .INIT .WAIT .WAITR .CLOSE 

5. 4. 5. 2 Functions 


Mnemonic 

Code 

Action 

. INIT 

1 

a. Return standard line buffer size (255^^ 

b. .SETUP API channel register 63g 

c. Set direction switch (input or output) 



NOTE 

In order to change direction when operating in a 
file-oriented environment, a new .INIT must first 
be executed. 

. DLETE 


a . . DLETE 

. FSTAT > 

. RENAM J 

2 

(1) Examines specified Directory 
for presence of desired file 
name. If not found, AC = 0 
upon return to user. 
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DECdisk Functions (Cont.) 


Mnemonic 


.SEEK 


.ENTER 


Code 


Action 


3 


4 


(2) Deletes file name (clears to 0) 
from the Directory of the 
specified unit. 

(3) Clears File Bit Map corresponding 
to deleted entry. 

(4) Clears corresponding occupancy 
bits in Directory Bit Map. 

(5) Records modified Directory and 
File Bit Map block on specified 
unit. 

b . . RENAM 

(1) Examines specified Directory 
for presence of desired file 
name. If not found, AC = 0 
upon return to user. 

(2) Changes file name in Directory 
to new one specified, by user 
program (no change is made to 
first block pointers) . 

(3) Records modified Directory on 
specified unit. 

c. .FSTAT 

Examines specified Directory for 
presence of desired file name. If 
not found, AC = 0 upon return to 
user. If found, AC = first block 
number of file. Also, bits 0-2 of 
CAL address +2 = 5 to designate the 
DECdisk,. 

a. Loads into core the Directory of the 
unit specified if the Directory is 
not already in core. 

b. Checks for presence of named file. 
(Error return to Monitor if not 
found . ) 

c. Begins transfer of first block of 
file into handler buffer area, over- 
laying Directory Entry section but 
not Directory Bit Map. 

d. Declares unit to be file-oriented. 

a. Loads into core the Directory of the 
unit specified if the Directory is 
not already in core. 

b. Checks for presence of named file. 

If present, pointer to that entry is 
saved for update at .CLOSE time. If 
not present, empty slot is found for 
file name insertion at .CLOSE time. 

c. Examines Directory Bit Map for free 
block and saves that block number for 
first transfer out and for insertion 
in Directory Entry Section at .CLOSE 
time . 

d. Declares unit to be file-oriented. 
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DECdisk Functions (Cont.) 


Mnemonic 

. CLEAR 

.CLOSE 


.MTAPE 


• READ 

.WRITE 


Code 


Action 


5 


6 


7 


10 


11 


a. Zeroes out File Bit Map blocks 71g 
through 77p on specified disk 
unit. 

b. Initializes Disk Directory block 

100 to indicate that 72,^ blocks 
(71g through lOOg and lOOOg 

through 1077g) are occupied. 

a. On input, clears internal program 
switches. On output, writes 2-cell 
EOF line as last line in output 
buffer (lOPS ASCII and Binary only) 
and outputs last data buffer with 
the data link = 777777. 

b. Loads into core the File Bit Map 
corresponding to the Directory 
Entry in order to clear the Directory 
Bit Map of bits for blocks formerly 
occupied by this file. 

c. Records newly constructed File Bit Map. 

d. Loads Directory into Memory, enters 
new Entry and Records Directory 
with new entry and updated Directory 
Bit Map. 

e. Clears internal program switches. 

a . Rewind 

(1) Initializes internal switches 

to permit data transfer beginning 
at block 0. 

(2) Declares the unit to be non-file- 
oriented (i.e. data will be 
recorded starting at block 0 and 
sequentially thereafter. 

b. Backspace - Decrements the internal 
block pointer to point to the next 
previous sequential record. 

c. Space Forward One Record - The block 
pointer is incremented by one to point 
to the next sequential record. 

d. Other .MTAPE functions ignored. 

a. Input line or block of data from 
handler’s buffer to user's buffer. 

b. When handler's buffer is empty, input 
next block from the disk. 

a. Output line or block of data from 
user's buffer to the handler's 
buffer. 

b. When handler's buffer is full, output 
a block of data to the disk examining 
the Directory Bit Map for the next 
free block number to store as the 
data link (word 377g) of the current 
block output. 
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DECdisk Functions (Cont.) 


Check I/O UNDERWAY: 

(1) If busy, return to CAL (.WAIT) 
or to the address in CAL + 2 
(.WAITR) . 

(2) If not busy, return to CAL + 2 
(.WAIT) or to CAL + 3 (.WAITR). 

Transfer the number of words specified 
(.TRAN arg) to (or from) the core area 
specified (.TRAN arg) from (or to) the 
disk block specified ( .TRAN arg) . Data 
is transferred from (or to) contiguous 
disk blocks in the forward direction 
(.TRAN arg). Transfer terminates when 
the word count (.TRAN arg) overflows. 
During output, however, if the word count 
is not equal to an integral number of 
disk blocks , the remaining words in the 
last block are zero-filled. 


5. 4. 5. 3 Legal Data Modes 

a. lOPS ASCII (Mode 2) RFA. , RFB . , RFC., RFD. , RFE . , RFF. 

b. lOPS Binary (Mode 0) RFA., RFB., RFC., RFD., RFE., RFF. 

c. Image Alphanumeric (Mode 3) RFA., RFD., RFE. 

d. Image Binary (Mode 1) RFA., RFD., RFE. 

e. Dump (Mode 4) RFA., RFD., RFE. 


5 . 4 . 5 . 4 Recoverable Errors 


Device Not Ready Monitor Error lOPS 4 

a. WRITE ENABLE the appropriate disk unit. 

b. Type CTRL R on the TTY. 


5 . 4 . 5 . 5 Unrecoverable Errors 


a. Illegal Function Monitor Error lOPS 6 

See 5. 4. 5.1 for legal handler functions. 

b. Illegal Data Mode Monitor Error lOPS 7 

(1) .SEEK executed with disk .INITed 
for output. 

(2) .ENTER executed with disk .INITed 
for input. 

(3) See 5. 4.5.1 for legal data modes 
for .READ and .WRITE. 

c. File Still Active Monitor Error lOPS 10 

.SEEK, .ENTER, .CLEAR, . DLETE , .FSTAT 

or .RENAM executed before a previously 

opened file has been .CLOSEd. 


.WAIT 12 

.WAITR 


.TRAN 13 
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d. .SEEK/. ENTER Monitor Error TOPS 11 

Not Executed A .READ or .WRITE has been executed 

prior to a .SEEK, .ENTER, or .MTAPE (Re- 
wind) . 

e. Disk Error Monitor Error lOPS 12 

EOT encountered during a .READ or .WRITE 
operation. 

f. File Not Found Monitor Error lOPS 13 

File named in a .SEEK not found in disk 
directory . 

g. Disk Directory Full Monitor Error lOPS 14 

Execution of .ENTER finds directory full. 

h. Disk Full Monitor Error lOPS 15 

No free block can be found during attempt 
to execute .WRITE or .ENTER. 

NOTE 

If block 0 is selected as the first block of a file 
(.WRITE or .ENTER) the disk unit will be declared 
full (lOPS 15) . Otherwise, execution of .FSTAT 
would produce ambiguous results, since .FSTAT returns 
either O's in the AC, if a file is not found, or the 
first block number of the file, if it is found. 


i. Output Buffer Monitor Error lOPS 16 

Overflow (1) The output line (lOPS Modes) is 

greater than 255^^ words (includ- 
ing header) . 

(2) The output block (Image Modes) is 
greater than 255.. „ (excluding 
header) , 

j . Excessive Number Monitor Error lOPS 17 

of Files Refer to 5.4.5 1 for file reference 

limitations . 

Monitor Error lOPS 21 

(1) Reference made to a nonexistent 
disk. Bits 15-17 of the CAL 
address output with the error 
message indicate the number of the 
disk platter referenced. 

(2) An illegal disk address was cal- 
culated from a legal initial start- 
ing address. The offending logical 
block number is output with the 
error message. 

Monitor Error lOPS 22 

Two output files are simultaneously open 
in the same unit. 

m. Illegal Word Pair Monitor Error lOPS 23 

Count Word pair count is 0 or greater than 177g. 

5.4.6 MT (Magnetic Tape 

5. 4. 6.1 General Description - Three handlers are provided for use with 
TU20 and TU20A Magnetic Tape Drives. 


k.. Illegal Disk 
Address 


1. Two Output Files 
on the Same Unit 
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MTA. (2432^q registers) is designed for file-oriented operations only. 
Up to three files may be concurrently referenced, all on different 
transports, either input or output. All data modes are allowed and all 
functions are legal except .MTAPE. 

MTC. (683^q registers) is a read-only handler having a single file 
capacity. Legal data modes are lOPS ASCII and Binary. Sequential file 
references are allowed. Legal functions are: 

.SEEK .INIT .CLOSE .READ .WAIT .WAITR 


MTF. (624^q registers) is a non-file-oriented, multi-unit handler which 
will accommodate (serially) up to eight concurrently open magnetic tape 
transports, both input and output. Only non-file-oriented operations 
are permitted. No internal buffering is performed. Legal data modes 
are lOPS ASCII and Binary. Legal functions are: 


.INIT .READ .WRITE .WAIT .WAITR .MTAPE (Rewind and 

Backspace) 


5. 4. 6. 2 Functions 


Mnemonic 

.INIT 


. DLETE 
.REN AM 
.FSTAT 


Code 

1 


2 


Action 

a. Return standard buffer size (255^^^) 

b. .SETUP - API channel register 45 g 

c. Set transfer direction (input or 
output) 

d. If first .INIT to this unit, assign 
default parity density and track-count 
settings (i.e., parity is odd, 
density is 800 BPI and track-count is 
as specified by .SCOM+4, bit 6: 

0=7 channel 
1=9 channel) 

e. Indicate that the referenced drive 
is open for I/O transfers. 

a. .DLETE 

(1) Examine the directory on the 
referenced unit for a file of 
the name specified. 

(2) If file is found, remove the 
name from the directory, zero 
the applicable accessibility bit, 
decrement the active file count, 
and re-record the directory. 

(3) Return with the AC / 0 . 
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Magnetic Tape Functions (Cont.) 


Mnemonic 


.SEEK 


.ENTER 


Code 


3 


4 


Action 


b . . RENAM 

(1) Search the directory on the 
referenced unit for an active 
file of the name given. If no 
file is found, return to the 
user with AC = 0 . 

(2) If file is found, replace the 
directory file name entry with 
the new file name and re-record 
the directory. 

(3) Return with the AC ^ 0 . 

c . . FSTAT 

(1) Set bits 0 through 2 of CAL +2=4. 

(2) Search directory for a file of 
the name given. If no file is 
found, return with the AC = 0 . 

(3) If a file is found, return with 
the AC = relative position of 
the file on tape (1 through 
374g) . Also, bits 0 through 2 
of CAL address +2 = 4 to 
designate Mag tape . 

a. Check that no file is open on the 
referenced unit. Take error return 
(lOPS 10) if so. 

b. Check that the referenced unit has 
been .INIT'ed for input. Take error 
return (lOPS 7) if not. 

c. Search directory for a file of the 
name given. If no file is found, 
error return (lOPS 13) to Monitor. 

d. Physically position the tape to read 
the first data block on the file. The 
handler-calculated file name must 
match the file name in the header 
label (lOPS 40 if not) . 

e . Indicate a file open for reading on 
the referenced unit. 

a. Check that no file is open on the 
referenced unit. Take error return 
(lOPS 10) if so. 

b. Check that the referenced unit has 
been declared an output unit. Error 
return (lOPS 7) if not. 
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Magnetic Tape Functions (Cont.) 


Mnemonic 

.ENTER 


. CLEAR 

.CLOSE 


Code 


Action 


(Cont.) c. Check that space is available in the 

File Name Entry Section of the 
Directory for this file name. Take 
error return (lOPS 14) if not. 

d. Check that space is available in 
the Accessibility Map for this file. 
Take error return ClOPS 42) if not. 

e. Indicate that a file is open for 
writing on the unit referenced. 

5 a. Rewind and write an empty File 

Directory at the front of the tape, 
along with a logical End-Of-Tape 
indicator. 


6 a. Input: Indicate that the referenced 

unit is no longer available for I/O 
transfers; return to caller. 

b. Output: 

(1) Non-File Structured Tape: Write 
two end-of-file markers, then 
backspace one to position the 
recording head between the two 
EOF markers written. Indicate 
that unit is no longer open for 
I/O transfers, and return to 
caller. 

(2) File-Structured Tape 

(a) Write the partial data buffer, 
if one is present. 

(b) Write trailer label and logi- 
cal end-of-tape indicator. 

(c) Search the File Directory 
for a name identical to that 
of the file being closed. If 
one is found, remove it from 
the Directory and set its 
accessibility to zero. 

(d) Add the new file name at the 
bottom of the Directory. 

(e) Update total and active file 
counts . 

(f) Re-record the Directory. 

(g) Indicate that unit is no 
longer open for I/O transfers , 
and return to caller. 


5-47 



Magnetic Tape Functions (Cont.) 


Mnemonic 

. MTAPE 


.READ 


Code 


Action 


7 


10 


a. Honor subfunction specification as 

follows : 

00 Rewind: Issue rewind to drive 
specified . 

01 Undefined: Error Return (lOPS 6) . 

02 Backspace Record: Issue a single 
backspace to the drive specified. 

03 Backspace File: Backspace until 
two EOF markers have been passed 
in reverse, then space forward 
one record. 

04 Write EOF: Write one EOF marker. 

05 Space Forward Record: Issue a 
single space forward to the drive 
specified. 

06 Space Forward File: Space for- 
ward until a single EOF marker is 
passed . 

07 Space to logical EOT: Space 
forward until two consecutive 
EOF markers are passed, then 
backspace one record. 

10 Describe Tape Configuration: 

thru Update the tape format descriptor 

17 bits for the drive specified. 

Subsequent I/O transfers (includ- 
ing space) will be performed in 
the density, parity, and channel- 
count given in .MTAPE 10 - 17, 
thus : 


Sub- 

function 

Channel 

Count 

Parity 

Density 

10 

7 

Even 

200 

BPI 

11 

7 

Even 

556 

BPI 

12 

7 

Even 

800 

BPI 

13 

9 

Even 

800 

BPI 

14 

7 

Odd 

200 

BPI 

15 

7 

Odd 

556 

BPI 

16 

7 

Odd 

800 

BPI 

17 

9 

Odd 

800 

BPI 


a. Check that referenced unit is input. 
lOPS 7 if not. 

b. Check that a file is open for read- 
ing : 

lOPS 11 if not. 

c. Initiate data transfer 

d. Read Errors 

(1) Parity/Checksum Errors 
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Magnetic Tape Functions (Cont.) 


Mnemonic 

.READ 


.WRITE 


Action 


(2) EOF Encountered. 

(a) File-Structured Environment. 
Modes 0-4: An EOF pseudo- 
line is constructed and stored 
in the user's line buffer area. 
The format of the 2-word line 
is as follows : 

Header word 0: 001005 

Header word 1: 776773 


(b) Non-File-Structured Environ- 
ment. 

Modes 0-3: An EOF pseudo- 
line is constructed and stored 
in the user's line buffer area. 
The format of the line is as 
follows : 

Header word 0: 001005 

Header word 1: 776773 

Data word 0: 000000 

Data v7ord 1 : Unchanged 

Mode 4 : No indication 

of End-Of-File is currently 
provided . 

(3) EOT Encountered 

(a) File-Structured Environment. 
Modes 0 - 4 : An EOM pseudo- 
line is constructed and stored 
in user's line buffer area. 

The format of the 2-word line 
is as follows: 

Header word 0: 001006 

Header word 1: 776772 


(b) Non-File-Structured Environ- 
ment . 

Modes 0-3: Exactly as 
described for file-structured 
environment (3a above). 

Mode 4: Error return 

(lOPS 43) . 

11 a. Check that referenced unit is output. 

lOPS 7 if not. 

b. Check that a file is open for writ- 
ing : 

lOPS 11 if not. 

c. Initiate data transfer. 

d. EOT: When physical End-Of-Tape is 
encountered during writing, an 
error return (lOPS 15) is made to 
the Monitor. Before control is given 
to the Monitor, the file being written 
is added to the Directory with the 
final two characters of the extension 
as "XX". 


Code 

(cont . ) 
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Magnetic Tape Functions (Cont.) 

Mnemonic Code Action 


•WRITE (cont.) e. Write Errors: Continued attempts are 

made to rewrite the record in error. 
The process terminates when EOT is 
encountered. 

.WAIT, .WAITR 12 a. Check I/O underway. 

(1) Busy: Return to CAL (.WAIT) or 
to address in CAL + 2 (.WAITR). 

(2) Non-Busy: Return to CAL + 2 
(.WAIT) or to CAL + 3 (.WAITR). 

NOTE 

On a non-busy return, the accumulator contains the 
contents of the magnetic tape status register as it 
appeared on completion of the latest operation. 

This is the only facility the user has for checking 
I/O errors in the .TRANS and dump-mode transfers. 

.TRAN 13 Honor subfunction indicator as follows: 

Subfunction Action 

0 Input Forward - Transfer next 

physical block on tape 
to user's buffer area. 

1 Output Forward - Transfer 

from user's buffer 
directly to the next 
physical block on tape. 

2 Illegal Function - Monitor 

Error lOPS 6 

3 Illegal Function - Monitor 

Error lOPS 6 


5. 4. 6. 3 Legal Data Modes 

a. lOPS Binary (Mode 0) 

(1) Acceptable handlers: MTA. , MTC. , MTF. 

(2) Output 

(a) File-structured Tape (MTA.) 

An attempt is made to pack the binary line into a 
257,Q-word buffer internal to MTA. if the line will 
nof^^fit, the current contents of the buffer are 
written and the line transmitted begins a new buffer. 
The line checksum is computed and stored in the 
second word of the line as it appears in MTA.'s 
buffer; the user ' s line-buffer checksum word is 
undisturbed. The buffer checksum (BCP word 2) is 
updated. Bits 12-13 in the user's line (in MTA.'s 
buffer) are set to 00. 

The maximum length of the line buffer, including the 
header pair, is 254, ^ words. The first word of the 
header is checked to ensure that the word-pair count 
is less than or equal to 177g and greater than 0. A 
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word-pair count equal to zero or greater than 177p 
results in an error return (lOPS 23) to the Monitor. 

Cb) Non-File-Structured Tape (MTF.) 

A check is made to ensure that the word-pair count 
is greater than zero. A 0 count results in an 
immediate error return (lOPS 23) to the Monitor. No 
check is made on the upper limit of the word-pair 
count; anything from l-377p is legal. The checksum 
is computed and stored in the second word of the line 
in the user's line buffer area. Bits 12 - 13 of this 
first header word are set to zero. The count of 
words to write is taken from the word-pair count in 
the header and transfer from the user's area is 
initiated. 

(3) Input 

(a) File-Structured Tape (MTA., MTC.) 

The line called for is unpacked from a 257^Q-word 
buffer internal to MTA. If the buffer was'^emptied 
by a previous .READ, or if this .READ is the first 
one, the buffer is refilled from the next physical 
block on tape. The line is stored in the user's 
line buffer area. Transmission from MTA.'s buffer 
stops when (a) the word-pair count in the input line 
or (b) the word count in the CAL sequence is satis- 
fied, whichever occurs first. In either case, the 
next-line pointer indicates the true subsequent line. 
In case of buffer overflow, bits 12 and 13 of the 
first header word are raised. (If buffer overflow 
does occur, the untransmitted portion of the line is 
no longer available to the caller.) 

Whether buffer overflow occurs or not, the validity 
bits (12-13) of the first header word are modified as 
follows and in the order indicated. First, the 
checksum for the line is calculated; if it is differ- 
ent from the transmitted checksum, bits 12 - 13 are 
set to 10. Next, a check is made for successful 
transfer of the entire block. In this context, 
"Successful Transfer" means (a) the block was read 
without hardware-detected error and (b) the block 
checksum (BCP Word 2) is correct. If transfer was 
unsuccessful, bits 12 - 13 are set to 01. 

(b) Non-File-Structured Tape (MTF.) 

The count of words to transfer is taken from CAL 
sequence, and input is initiated from the next 
physical block on tape directly to the user's line- 
buffer area. When the read is complete, the line 
validity bits are modified under the following condi- 
tions and in the order indicated. First, bits 12 - 13 
of header word 0 are set if buffer overflow occurred. 
Next, a checksum is calculated (if buffer overflow 
did not occur) and compared with the checksum read. 

If the two checksums differ, bits 12 - 13 are set to 
10. Finally, a check is made to ensure that the line 
was transferred without hardware-detected error. If 
an error occurred, bits 12 - 13 are set to 01. If 
no errors of the types described are encountered, 
bits 12-13 are unchanged. 
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b. Image Binary (Mode 1) 

(1) Acceptable Handlers: MTA. 

(2) Handler operation is exactly as described for lOPS Binary 
(above) . Headers and data are transferred in file- 
structured mode. Modifications are limited to the check- 
sum word and the validity field as stated above. 

c. lOPS ASCII (Mode 2) 

(1) Acceptable Handlers: MTA., MTC. , MTF. 

(2) Operation is the same as described for lOPS Binary Mode 
(above) . 

d. Image Alphanumeric (Mode 3) 

(1) Acceptable Handlers: MTA. 

(2) File-Structured Tape 

Handler activity is exactly as described for lOPS Binary, 
above. In the file-structured environment, headers and 
data are transferred and modifications, when applicable, 
are carried out only on the checksum word and validity 
field. 

e. Dump (Mode 4) 

(1) Acceptable Handlers: MTA. 

(2) Dump Mode is used to read into or write from specified areas 
of core, under count control, without the need for line 
buffers. The action taken by MTA. in honoring Dump Mode 
.READS and .WRITES is identical in both file-structured and 
non-file-structured environments . 

(a) Output 

Data is taken from the core area specified in the CAL 
sequence and stored starting in the next available 
place in MTA.'s buffer. When the buffer is filled, 
it is written out and transmission to the new 
buffer continues until the count in the CAL sequence 
is fulfilled. The partly-filled buffer, if one 
remains, is not written at the completion of the 
operation. Data is transferred in 255^Q-word incre- 
ments. The dump mode buffer as wri tten^includes 
the BCP for a total block length on tape of 257, „ 
words . 

(b) Input 

Data is taken from the handler buffer and stored 
sequentially starting at the core location given in 
the CAL argument list. Transmission continues until 
the word count in the CAL sequence is satisfied. If 
the handler buffer is emptied in the process, it is 
refilled from the next physical block on tape. 

(c) Read/Write Errors 

There is presently no facility for indicating I/O 
errors to the caller while dump mode is being used. 
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5.4.6. 4 Recoverable Errors 

lOPS 4 (Device Not Ready) 


a. Cause: 

(1) Transport OFF LINE 

(2) Unit number incorrect 

(3) Attempt to .WRITE with WRITE LOCK set to ON 

(4) 9-Channel I/O request to a 7-channel transport 
(and vice-versa) 


b. Recovery: 

(1) Correct fault 

(2) Type CTRL R 

5. 4. 6. 5 Unrecoverable Errors 


a. Illegal Function - Monitor Error lOPS 6 

(1) Attempt to execute file-structured to non-file 
structured transport (and vice-versa) 

(2) An input request made to an output unit (and 
vice-versa) 

(3) A .TRAN was attempted in the reverse direction 

b. Illegal Data Mode - Monitor Error lOPS 7 

Illegal data mode for particular handler version 
(see 5 . 4 . 6 . 4) . 

c. File Still Active - Monitor Error lOPS 10 

A .SEEK, .ENTER, .CLEAR, .RENAME, . DLETE , or 
.FSTAT requested while a file is still open on 
the specified unit. 

d. SEEK/ENTER Not Executed - Monitor Error lOPS 11 

A .READ or .WRITE has been requested to a file- 
structured transport without performing either 
a .SEEK or a .E TER. 

e. EOT Encountered on Read - Monitor Error lOPS 12 

Physical End-Of-Tape encountered during an input 
operation . 

f. File Not Found - Monitor Error lOPS 13 

During the processing of a .SEEK, the requested 
file name is absent from the File Name Entry 
Section of the specified Directory. 
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g. Directory Overflow - Monitor Error lOPS 14 

During the processing of .ENTER, the File Name 
Entry Section of the Directory is discovered to 
be full. 


i. Output Buffer Overflow - Monitor Error lOPS 16 

lOPS ASCII or lOPS Binary line exceeds 255, ^ words 
(including header pair) . 


j. Word Pair Count Error - Monitor Error lOPS 23 

During an lOPS Mode transfer, the Word Pair Count 
is found to be less than 1 or greater than 111 

k. Too Many Files - Monitor Error lOPS 17 

An excessive number of files are currently referenced. 


1. Header Label Error - Monitor Error lOPS 40 

During the processing of a .SEEK, the handler 
calculated file name is discovered to be different 
from the name present in the file header label. 


m. Directory Format Error - Monitor Error lOPS 41 

Illegal or meaningless data was found in the File 
Directory . 


n. Accessibility Map Overflow - Monitor Error lOPS 42 

During the processing of a .ENTER, the Accessibility 
Map is found to be full. 


o. Directory Recording Error - Monitor Error lOPS 43 

A write error is encountered during the recording of 
a Directory. 


p. Logical EOT Found - Monitor Error lOPS 44 

Logical End-Of-Tape encountered during the processing 
of a .SEEK or a .ENTER. 


q. Long Input Record - Monitor Error lOPS 45 

Input record read tape is too long to fit in the 
handler's buffer. 
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5.4.7 LPA. (Line Printers LP15C and LP15F) 


5. 4. 7.1 General Description - LPA. (311^^ registers) is designed to 
operate Line Printers LP15 (132 columns) and LP15F (80 columns) . Legal 
data modes are lOPS ASCII and Image Alphanumeric. Functions are as 
follows : 


.INIT .WRITE .WAIT .WAITR .CLOSE 


5. 4. 7. 2 Functions 


Mnemonic Code 


Action 


.INIT 1 a. Return standard buffer size: 

(1) 54^q (LP15C) 

(2) 36^q (LP15F) 

NOTE 

.SCOM+4, bit 12 determines printer 
column size. 

0 = 80 column 

1 = 132 column 

b. .SETUP - API channel register 56 g 

c. Output FORM Feed and determine if 
subsequent FORM Feeds should be 
issued every 57 lines. Bit 6 of the 
.INIT CAL is tested as follows: 

0 = FORM Feed every 57 lines 

1 = No FORM Feed 

Bit 6 is set by using a 5 rather 
than a 1 as the "F" argument of 
the .INIT (see 3.1.2) . 


. DLETE 

.RENAM 

.FSTAT 

.SEEK 

.ENTER 

. CLEAR 

. CLOSE 


.MTAPE 

.READ 

.WRITE 


2 Ignore 

3 Illegal Function - Monitor Error lOPS 6 

4 Ignore 

5 Ignore 

6 a. Allow previous output to terminate. 

b. Output FORM Feed (if not inhibited 
in the .INIT) and allow it to 
terminate . 

7 Ignore 

10 Illegal Function - Monitor Error lOPS 6 

11 a. Allow previous output to terminate. 

b. Examine word 0 of the user's header 
word pair as follows: 
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LPA. Functions (Cont.) 


Mnemonic 

.WRITE 


Action 


Signifies 

0 = Enter Single Line Mode 

1 = Enter Multiple Line Mode 

Line count for Multiple Line 
Mode. 

0 = lOPS ASCII Mode 

1 = Image Alphanumeric Mode 

NOTE 

The user must explicitly set the 
data mode (Bit 17) in his line 
buffer as the handler does not 
examine the .V7RITE macro for this 
information . 

If in Multiple Line Mode, step "c" 
(below) is not performed. 

c. Check the first character of the user's 
buffer for the following vertical 
form control characters, all of 
which are output by the FORTRAN IV 
Object Time System: 

014 Form Feed 

020 Overprint 

021 Print every second line 

012 Line Feed 

To effect the Overprint function for 
FORTRAN users, it is necessary to 
simulate certain vertical form con- 
trol characters. If the first char- 
acter of a line is 012, 014, or 021, 
the handler automatically enters 
Multiple Line Mode (by setting bit 0 
of the first word in the user's buffer 
to 1) and prints two lines/ the 
first line being the vertical control 
character, and the second line being 
the actual data If the first char- 
acter is 020 (Overprint) , it is re- 
placed in the user's buffer by 015 
(Carriage Return) which does not 
affect the page position and both 
lines are printed. All other charac- 
ters cause a Line Feed to be output 
from the handler's internal buffer 
followed by the line from the user's 
buffer. After output, any data in 
the user's buffer which was changed 
(i.e., header word 0 or the first 
data word) is restored. 

If the user intends to output to 
another device from the same line 
buffer (e.g., two sequential .WRITES), 
a .WAIT should be used after the 
.WRITE referencing the Line Printer 
to permit the restoration of any data 
which may have been replaced in the 
user's buffer by LPA. 


Code 


(cont . ) 


Bit 

0 

1-8 


17 
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LPA. Functions (Cont.) 

Mnemonic Co de Action 

d. Output in either Single Line Mode or 
Multiple Line Mode as applicable. 

e. Restore modified portions of the 
user's buffer (if changed). 

Check I/O UNDERWAY 

(1) Busy - Return to CAL (.WAIT) or 
to address in CAL + 2 (.WAITR). 

(2) Non-busy - Return to CAL + 2 
(.WAIT) or to CAL + 3 (.WAITR). 

Illegal Function - Monitor Error lOPS 6. 

5. 4. 7. 3 Legal Data Modes 

a. lOPS ASCII (Mode 2) 

b. Image Alphanumeric (Mode 3) 

5.4. 7. 4 Carriage Control Characters - The following vertical control 
characters, except horizontal TAB, cause line termination except for 
special cases described under .WRITE (above) . 

Character Action 


.WRITE (cont.) 


.WAIT 12 

.WAITR 


.TRAN 13 


Line Feed (012o) 

O 

VT (Vertical Tab, 013g) 
Form Feed (014o) 

O 

Carriage Return (OISq) 

O 

DLE (040_) 

o 

DCl (04lg) 

DC2 (022g) 

DC3 (023g) 

DC4 (024g) 

ALT MODE (175o) 

O 


Space one line 
Space 20 lines 


Move to top of form 


Reset column count to zero (no implicit 
LINE FEED function) 


Space 30 lines 
Space 2 lines 
Space 3 lines 
Space 1 line 
Space 10 lines 


Refer to Appendix A 
for equivalent 
teleprinter characters 


Reset column count to zero (no implicit 
LINE FEED function) 


Horizontal TAB (Ollg) Output sufficient number of spaces to 

(The horizontal position printer at column 9, 17, 25, 

control character . . . etc. 

Horizontal Tab does 
not terminate the line 
and may occur anywhere 
in the line. 
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5. 4. 7. 5 Recoverable Errors 


Printer Not Ready - Monitor Error lOPS 4 


Cause 

(1) 

Off Line 

C2) 

Out of Paper 

(3) 

Yoke Open 

(4) 

Alarm Status 


b. Recovery - Ready the line printer and type CTRL R. 
5. 4. 7.6 Unrecoverable Errors 


a. Illegal Function - Monitor Error lOPS 6 

Attempt to execute .SEEK, .READ, or .TRAN 

b. Illegal Data Mode - Monitor Error lOPS 7 

Attempt to output in Data Modes other 
than lOPS ASCII or Image Alphanumeric. 

c. Line Over - Monitor Error lOPS 37 

The 81st or 133rd character (depending upon 
printer type) has been reached without 
encountering a vertical control character 
(Multiple Line Operation only) . 

d. Illegal Horizontal TAB - Monitor Error lOPS 47 

An attempt has been made to execute a 
Horizontal TAB (Multiple Line Mode only) 
causing the column count to exceed that 
required for the last tab stop (72 or 124 
depending upon the printer type) . 


5.4.8 CDB. (CR03B Card Reader) 

5.4. 8.1 General Description - CDB. (415^^^ registers) is an lOPS ASCII 
handler which operates the CR03B Card Reader. The handler is supplied 
to the user in source form and, when assembled, operates with cards 
punched in 029 Hollerith Code. By defining the assembly parameter 
"DEC026+1", the handler can be assembled to accept cards punched in 
026 Hollerith Code, 

5. 4. 8.2 Functions 

Mnemonic Code Action 


.INIT 


1 


a. Return standard buffer size (52^^) . 

b. .SETUP API channel register 55 g. 
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CDB. Functions (Cont.) 


Mnemonic Code 


Action 


. DLETE 
.RENAM 
.FSTAT 


2 Ignore 


.SEEK 
.ENTER 
.CLEAR 
. CLOSE 


3 Ignore 

4 Illegal Function - Monitor Error lOPS 6 

5 Illegal Function - Monitor Error lOPS 6 

6 Allow previously requested input to 

terminate. 


. MTAPE 


7 Ignore 


.READ 


.WRITE 

.WAIT 

.WAITR 


.TRAN 


10 

a. 

Allow previously requested input 
to terminate. 


b. 

Check that device is ready. 


c. 

Input next card. 


11 Illegal Function - Monitor Error lOPS 6 

12 Check I/O UNDERWAY 

(1) Busy - Return to CAL (.WAIT) or 
to address in CAL + 2 (.WAITR). 

(2) Non-busy - Return to CAL + 2 
(.WAIT) or to CAL + 3 (.WAITR). 

13 Illegal Function - Monitor Error lOPS 6 


5.4. 8.3 Legal Data Modes 


lOPS ASCII (Mode 2) 

Eighty card columns are read and interpreted as 029 (or 026) 
Hollerith data, mapped into the corresponding 64-graphic subset 
of ASCII, and stored in the user's line buffer in 5/7 format 
(36 j^q locations are required to store an 80 column card) . Com- 
pression of internal blanks to tabs and truncation of trailing 
blanks is not performed (all 80 characters appearing on the card 
are delivered to the user's buffer). In addition, a Carriage 
RETURN (015g) character is appended to the input line; thus, a 
total of 81°characters are returned to the user. 

All illegal punch configurations (i.e., those not appearing in 
the 029 or 026 character set, as applicable) are interpreted as 
validity errors and will cause an lOPS 4 error condition. The 
card containing the error must be repunched. 

In addition to the Hollerith character set, the handler recognizes 
the ALT MODE terminator (necessary for system programs). ALT MODE, 
recognized as a 12-1-8 code (multiple-punched A8) , is mapped in 
to the standard ALT MODE character (175 g) in the user's buffer. 

Each file must be terminated with an EOF card (all punch positions 
in card column 1 perforated) , which may be created by multiple- 
punching characters: +-0123456 789 . 
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When a card has been processed, word 0 of the header word pair 
is constructed and stored in the user's line buffer. Word 1 of 
the header (checksum word) is not changed. 

Refer to Appendix B for a listing of legal Hollerith codes and 
corresponding ASCII graphics. 

5. 4. 8. 4 Recoverable Errors 


Reader Not Ready - lOPS 4 

a. Causes 

(1) Hopper Empty 

(2) Stacker Full 

(3) Feed Check (may be hardware failure) 

(4) Read Check (may be hardware failure) 

(5) STOP button depressed 

(6) START button not depressed 

(7) End of card deck. Add more cards or EOF card. 

(8) Validity Error (VALIDITY switch ON) - unrecognizable 
punch configuration. 

(9) Pick Fail - Card selected, but not passed from 
hopper to read station. 

b. Recovery 

Remedy error condition and type CTRL R. 

5.4. 8.5 Unrecoverable Errors 


a. Illegal Function - Monitor Error lOPS 6 

An attempt was made to execute a .ENTER, 
.CLEAR, .WRITE, or a .TRAN. 

b. Illegal Data Mode - Monitor Error lOPS 7 

A request for transfer was made in a 
data mode other than lOPS ASCII. 


5.4.9 VPA. (VP15A Storage Tube Display) 

5. 4. 9.1 General Description - VPA. (612^^ registers) operates the VP15A 
Storage Tube Display. Legal data modes are lOPS ASCII, Image Alpha- 
numeric, and Dump. Handler functions are as follows: 

.INIT, .WRITE, .WAIT, .WAITR, .FSTAT, .CLOSE 
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5 . 4 . 9 . 2 Functions 


Mnemonic Code Action 

. INIT 1 a. Return standard line buffer size (34^^) 

b. .SETUP API channel register (54^) 

O 

c. Set X and Y coordinates to position 
the beam at the top left corner of 
the screen (one line above the 
first visible line) . 

d. Set I/O UNDERWAY indicator. 

e. Erase the screen 


. RENAM 

. DLETE 

j 

Ignore 

.FSTAT 

2 

Check to see if file-oriented. 

.SEEK 

3 

Illegal Function - Monitor Error lOPS 6 

. ENTER 

4 

Ignore 

. CLEAR 

5 

Ignore 

. CLOSE 

6 

Allow previous output to terminate. 

. MTAPE 

7 

Ignore 

• READ 

10 

Illegal Function - Monitor Error lOPS 6 

.WRITE 

11 

a. Set I/O UNDERWAY indicator 

b. Allow previous output to terminate 

c. Display data 

. WAIT 

12 

Check I/O UNDERWAY: 

.WAITR 


(1) Busy - Return to CAL (.WAIT) or 
to address in CAL + 2 (.WAITR) . 

(2) Non-busy - Return to CAL + 2 
(.WAIT) or to CAL + 3 (.WAITR). 

Legal 

Data Modes 


lOPS 

ASCII (Mode 2) 

Scale 2 

lOPS 

ASCII (Mode 12) Scale 4 

Image 

1 Alphanumeric 

(Mode 3) 

Dump 

(Mode 4) Store 

Mode 

Dump 

(Mode 14) Non- 

store Mode 


5. 4. 9. 4 Data Mode Functions 

a. lOPS ASCII (Modes 2 and 12) - These data modes allow 5/7 
ASCII to be displayed from the addressed line buffer. 
Header word pair and word pair count must be supplied. 
Data Mode 2 displays characters using a scale of 2. Data 
Mode 12 displays characters using a scale of 4. 
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b. Image Alphanumeric (Data Mode 3) - This data mode allows 7 or 8 
bit ASCII stored one character per word in the addressed line 
buffer to be displayed. Header word pair and word pair count 
must be supplied. Characters may be displayed at any legal 
scale (1 - 31 j^q) . Each data word may be used to specify a 
different scale factor, as shown below. If bit 0 is set 
to 1, the handler determines a new scale factor from bits 
1-5. If bit 0 is set to 0, bits 1-5 are ignored and the 
previous scale factor is used. 



Bit 17 


1 = enable scale change 
0 = no scale change 


VPA Image ASCII Word Structure 


c. Dump (Data Modes 4 and 14) - These data modes allow one 

point for each data word in the addressed line buffer to be 
displayed (no header word pair required) . Each data word 
in the buffer is treated as two 9-bit coordinates which 
describe the location of a point. Bits 0 through 8 represent 
the X coordinate value while bits 9 through 17 represent the 
Y coordinate value. Data Mode 4 selects Store Mode and Data 
Mode 14 selects Non-store Mode which, during assembly, causes 
Bit 5 of the first word of the .WRITE macro expansion to be 
set either to 0 (Store Mode) or 1 (Non-store Mode) . Points 
plotted in Store Mode will remain visible for periods up to 
15 minutes. Points plotted in Non-store Mode, however, must 
be refreshed at least 30 times per second to remain visible. 
This feature is particularly useful for repeatedly displaying 
a small movable figure such as a cursor. Also, a single 
Non-store point may be utilized for setting a starting point 
for ASCII text or Store Mode plots. 


5. 4. 9. 5 Special Characters 


a. A Carriage RETURN terminates an output character string and 
automatically initiates a Carriage RETURN/LINE FEED sequence 
(lOPS only) . 

b. An ALT MODE terminates an output character string but does 
not alter the beam position (lOPS only) . 

c. LINE FEED moves the beam down one line (horizontal position 
not affected) . 

d. Horizontal TAB causes a sufficient number of spaces to be 
output to place the beam in character positions 9, 17, 25, 

... 70. 

e. FORM Feed erases the screen and repositions the beam to the 
first character position of the first line. It is not a legal 
terminator and may appear at the beginning of a line. 
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5 . 4 . 9 . 6 Printing Rules 


a. When using a Scale Factor of 2 (default assumption in lOPS 
ASCII), the VP15A displays 72 characters per line and 56 
lines per "page". 

b. If the screen has been filled with 56 lines, a subsequent 
lOPS ASCII .WRITE command will cause the display to be 
erased and the new line to be displayed at the top of the 
screen. 

c. If the beam has been positioned at the bottom line of the 
screen by a Dump Mode (non-store) .WRITE and two subsequent 
ASCII .WRITES are issued, and the second ASCII .WRITE will 
cause the display to be erased as in "b" above. 

d. When using Image ASCII Mode, the user must set the starting 
point for the first line to be output after device initializa- 
tion (.INIT). This may be accomplished either by issuing a 
Dump Mode .WRITE referencing the desired starting point, or 

by including a LINE FEED as the first character in the line 
buffer (first word after the header word pair) . 


5. 4. 9. 7 Unrecoverable Errors 


a. Illegal Function - Monitor Error lOPS 6 

An attempt to execute a .SEEK or .READ 
has been detected. 

b. Illegal Data Mode - Monitor Error lOPS 7 

See 5. 4. 9. 3. 
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APPENDIX A 
PDP-15 lOPS ASCII CHARACTER SET 


Listed below are the ASCII characters interpreted by the ADVANCED Monitor and system programs as meaningful 
data input or as control characters. 



00-37 

40-77 

— 

100-137 

140-177 


ASCII 

CHAR. 

ASCII 

CHAR. 

ASCII 

CHAR. 

ASCII 

CHAR. 

0 

NUL 

SP 

@ 


0 

1 

SOH (CTRL A) 

I 

A 


1 

2 


M 

B 


2 

3 

ETX (CTRL C) 

# 

C 


3 

4 

EOT (CTRL D) 

$ 

D 


4 

5 


% 

E 


5 

6 


& 

F 


6 

7 


' 

G 


7 

10 


( 

H 


10 

11 

HT 

) 

I 


11 

12 

LF 

* 

J 


12 

13 

VT 

+ 

K 


13 

14 

FF 

/ 

L 


14 

15 

. CR 

- 

M 


15 

16 



N 


16 

17 


/ 

O 


17 

20 

DLE (CTRL P) 

0 

P 


20 

21 

DC1 (CTRL Q) 

1 

Q 


21 

22 

DC2 (CTRL R) 

2 

R 


22 

23 

DC3 (CTRL S) 

3 

S 


23 

24 

DC4 (CTRL T) 

4 

T 


24 

25 

NACK (CTRL U) 

5 

U 


25 

26 


6 

V 


26 

27 


7 

w 


27 

30 

CNCL (CTRLX) 

8 

X 


30 

31 


9 

Y 


31 

32 

SS (CTRL Z) 

: 

z 


32 

33 

ESC (ALTMODE) 

r 



33 

34 


< 



34 

35 


= 


ESC (ALTMODE) 

35 

36 


> 

A or t 

ESC (ALTMODE) 

36 

37 


? 

^or 

delete (RO) 

37 




(underscore) 




*Codes 33, 176, 175 are interpreted as ESC (ALT Mode) and are converted on input to code 175 by lOPS handlers. 
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APPENDIX B 

PDP-15 ASCII/HOLLERITH CORRESPONDENCE 


ASCII 


HOLLERITH 

ASCII 


HOLLERITH 

CHAR. 

7-BIT 

CODE 

DEC 029 

DEC 026 

CHAR. 

7-BIT 

CODE 

DEC 029 

DEC 026 

SP 

40 

None 

None 

@ 

100 

4-8 

8-4 

1 

41 

11-2-8 

12-8-7 

A 

101 

12-1 

12-1 


42 

7-8 

0-8-5 

B 

■Eh 

12-2 

12-2 

# 

43 

3-8 

0-8-6 

C 

■eh 

12-3 

12-3 

S 

44 

1 1-3-8 

1 1-8-3 

D 

104 

12-4 

12-4 

% 

45 

0-4-8 

0-8-7 

E 

105 

12-5 

12-5 

& 

46 

12 

1 1-8-7 

F 

106 

12-6 

12-6 


47 

5-8 

8-6 

G 

107 

12-7 

12-7 

( 

50 

12-5-8 

0-8-4 

H 

110 

12-8 

12-8 

) 

51 

11-5-8 

1 2-8-4 

1 

111 

12-9 

12-9 

* 

52 

11-4-8 

11-8-4 

J 

112 

1 1-1 

11-1 

+ 

53 

12-6-8 

12 

K 

113 

1 1-2 

11-2 


54 

0-3-8 

0-8-3 

L 

114 

1 1-3 

11-3 

- 

55 

1 1 

11 

M 

115 

1 1-4 

11-4 


56 

12-3-8 

1 2-8-3 

N 

116 

1 1-5 

11-5 

/ 

57 

0-1 

0-1 

0 

117 

1 1-6 

11-6 

0 

60 

0 

0 

P 

120 

1 1-7 

11-7 

1 

61 

1 

1 

Q 

121 

1 1-8 

11-8 

2 

62 

2 

2 

R 

122 

1 1-9 

11-9 

3 

63 

3 

3 

S 

123 

0-2 

0-2 

4 

64 

4 

4 

T 

124 

0-3 

0-3 

5 

65 

5 

5 

U 

125 

0-4 

0-4 

6 

66 

6 

6 

V 

126 

0-5 

0-5 

7 

67 

7 

7 

W 

127 

0-6 

0-6 

8 

70 

8 

8 

X 

130 

0-7 

0-7 

9 

71 

9 

9 

Y 

131 

0-8 

0-8 


72 

2-8 

11-8-2 

Z 

132 

0-9 

0-9 


73 

1 1-6-8 

0-8-2 

I 

133 

12-2-8 

11-8-5 

< 

74 

12-4-8 

1 2-8-6 

" 

134 

1 1-7-8 

8-7 

= 

75 

6-8 

8-3 

1 

135 

9 

00 

1 2-8-5 

> 

76 

0-6-8 

11-8-6 

t or A 

136 

1 2-7-8 

8-5 

7 

77 

0-7-8 

1 2-8-2 

■«- or — 

( underscore ) 

137 

0-5-8 

8-2 


NOTES: 1 . ASCII code 0-37 and 140-177 have no corresponding codes in the Hollerith set and therefore are 
not shown. 

2. ALT Mode is simulated by 12-1-8 punch. 

3. The card reader interface actually supplies a direct binary equivalent of the column punch. The 
octal codes given above are those generated by the handler from the column punches. 
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APPENDIX C 


ADVANCED MONITOR ERROR PRINTOUTS 


Errors 


Explanation 


BAD DEV - ERR 


BAD .DAT SLOT - 
IGNORED FROM ERR 


Illegal device reference, for example: 

A PRA 5,6/PPW7/DTA-5 

where the command is processed and 
effective up to the PPW and the remainder 
of the command is ignored. 

Illegal .DAT slot reference, for 
example : 

A PRA 5,6/PPA G 

where the command is processed and 
effective through A PRA 5,6 but ignored 
from there on. 


Non-existent program name. Command 
ignored. 

Command attempted to assign a device 
handler to one of the permanent .DAT 
slots (-2, -3, or -7). 

Illegal unit reference (e.g., DTAX) 

Illegal address given in "GET n address" 
command . 

SYS DEV ERR - TRY AGAIN Last command types caused error condi- 
tion on system device control. 

BAD COMMAND IN BATCH Illegal Batch Processor commands: 

MODE QDUMP, HALT, GET (all forms), BATCH, 

LOAD, DDT, or DDTNS . 


BAD PROGNAM 

PERM .DAT SLOT 

BAD UNIT - 

ignored from err 

BAD START LOC 


BAD BATCH DEF Batch device was not designated properly. 

Should be: 

CD - for card reader 

PR - for paper tape reader 
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APPENDIX D 


LINKING LOADER AND SYSTEM LOADER ERRORS 

The following error codes are output by the Linking Loader and by the 
System Loader. When output by the Linking Loader, the errors are 
identified as shown below. When output by the System Loader, the errors 
are identified as ".SYSLD n" instead of ".LOAD n" . 


Error 


Meaning 


.LOAD 1 


.LOAD 2 


.LOAD 3 


.LOAD 4 


Memory overflow - the Loader's symbol table and 
the user's program have overlapped. At this 
point the Loader memory map will show the 
addresses of all programs loaded successfully 
before the overflow. Increased use of COMMON 
storage may allow the program to be loaded as 
COMMON can overlay the Loader and its symbol table, 
since it is not loaded into until run time. 

Input data error - parity error, checksum error, 
illegal data code, or buffer overflow (input line 
bigger than Loader's buffer). 

Unresolved Globals - any programs or subroutines 
required but not found, whether called explicitly 
or implicitly, are indicated in the memory map 
with an address of 00000. If any of the entries 
in the memory map have a 00000 address, loading 
was not successful; the cause of trouble should 
be remedied and the procedure repeated. 

Illegal .DAT slot request - the .DAT slot 
requested was: 

a. Out of range of legal .DAT slot numbers, 

b. Zero, 

c. Unassigned; that is, was not set up at 
System Generation Time or was not set up 
by an ASSIGN command. 
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APPENDIX E 


lOPS ERRORS 


Error Code Error Error Data Comments 

0 Illegal Function CAL address The address points to a CAL which 

CAL did not have a legal function code 

(1 to 16) in bits 3 to 17 of the 
word after the CAL. 

1 CAL* illegal CAL address The instruction CAL* (Indirect) 

is an illegal Monitor CAL. 

2 .DAT slot error CAL address 1. The .DAT slot number in Bits 

9 to 17 of the CAL was 0, 
greater than 10, or less than 

-15. 

2. The .DAT slot did not contain 
a handler address (no .lODEV 
was given for this .DAT slot.) 

An interrupt occurred which did 
not have an active device handler 
associated with it. The contents 
of the lORS word at the time of 
the interrupt is printed out. 

This error can occur whenever 
any not ready condition occurs. 

1. DECtape or MAGtape - unit not 
selected or not write enalDled. 

2. Punch - out of paper tape. 

3. Line printer - off line. 

4. Card reader - off line, out 
of cards, stacks full, or 
card jam. 

5 Illegal .SETUP CAL address Use of .SETUP when appropriate 

CAL skip not placed in skip chain at 

system generation time. 

6 Illegal handler CAL address A function (.READ, .WRITE, etc.) 

function was issued to a handler which is 

incapable of performing that 
function (.READ to paper tape 
punch, .WRITE to C version of 
handler (Read only) ) . 

CAL address 1. Illegal data mode for this 

version of the handler used. 

2. Use of input commands after 
device has been .INITed for 
output . 

10 File still CAL address Failure to close a file before 

active another SEEK or ENTER on the 

same .DAT slot. 

11 SEEK/ENTER not CAL address A read or write was issued with- 

executed out a prior SEEK, ENTER, or 

MTAPE command. 


7 Illegal data 

mode 


3 Illegal I/O status 

interrupt 


4 Device not ready 

(type control R 
when ready) 
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Error Code 

Error 

Error Data 

Comments 

12 

Unrecoverable 
DECtape error 
(MARK TRACK) 

DECtape status 
register B and 
Unit Number 

DECtape error with status register 
B in bits 0 to 11 and the unit 
number in bits 15 to 17. 

Reformat tape. 

13 

File not found 

CAL address 

The file name specified by the 
directory entry section (pointer 
to entry is in CAL address plus 

2 ) was not found. 

14 

Directory full 

CAL address 

The directory entry section of 
the current device in use is 
full. 

15 

DECtape full 

CAL address 

All blocks available for file 
storage are currently full. 

16 

Output buffer 
overflow 

C^ address 

The word pair count on the current 
.WRITE is greater than 111 ^. 

17 

Too many files 
for handler 

CAL address 

Too many files are currently open 
on the handler referenced by this 
CAL (e.g. , 4 files on DTA will 
cause error while 2 files on DTD 
would cause same error) . 

20 

Reserved 



21 

Reserved 



22 

Two output files 
on one unit 

CAL address 

Two concurrent output files have 
been opened on one unit. 

23 

Illegal Word 

Pair Count 

Sector 

address 

The word pair count on the 
current input or output line 
equals zero or greater than 

1773 . 

24 

Reserved 



25 

Reserved 



26 

Reserved 



27 

Reserved 



30 

API software 
level error 

API status 
register 

An API break occurred to a soft- 
ware level which did not have 
the appropriate transfer vector 
set up in .SCOM + 12 to .SCOM + 15 

31 

Non-existent 

memory 

reference 

Program 

counter 

Non-existent memory reference 
with protect mode on without a 
user defined violation routine. 

32 

Memory protect 
violation 

Program 

counter 

Reference to a location below 
the memory protect boundary 
without a user defined violation 
routine . 

33 

Memory parity 
error 

Program 

counter 

Memory parity error without a 
user defined parity error routine. 
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Error Code 

Error 

Error Data 

Comments 

34 

Power fail with 
no skip setup 

Program 

counter 

Power low flag came up but a 
user defined routine to save 
appropriate registers not in 
core . 

35 

Reserved 



40 

Header label 
errors 

CAL address 

The internal header label for 
the currently opened file is 
incorrect . 

41 

Directory 
format error 

CAL address 

Bad data in file directory. 

42 

Accessibility 

Map overflow 

CAL address 

Too many files recorded in the 
current MAGtape. Use MTDUMP 
to retrieve storage occupied by 
unwanted files. 

43 

Reserved 



44 

Logical EOT 

CAL address 

An unexpected logical end-of- 
tape was encountered during 
the processing of .SEEK or 
.ENTER. 

45 

Long Input 

Record 

CAL address 

The record read from tape is 
too^arge to be accommodated 
by the handler's buffer. 

46 

Attempt to 
delete System 
File 

CAL address 

The user has requested deletion 
of a file whose extension is 
in "S.YS" . 

47 

Illegal Hori- 
zontal Tab 

CAL address 

The line printer received a 
Horizontal Tab after the 72nd 
or 128th character (depending 
on the model) . The remainder 
of the line is lost. 

61 

Parity Error 
while reading 

CAL address 

Defective data. DECtape or 
DECdisk drive (see NOTE below) . 


Directory or 
File Bit Map 
Blocks 


NOTE 


Recovery procedures; 

1. Repeat operation which caused error. 

2. Remount DECtape on another drive and repeat step 1. 

3. If you are very familiar with DECtape file structure 
and have a reasonably current directory, proceed as 
follows ; 

a. Use PIP to Block Copy each file on the defective 
tape to a fresh tape (directory provides starting 
block number of each file) . 

b. Use PATCH to reconstruct a new directory on the 
new tape (do not write on this tape - it has no 
file bit maps) . 

c. Use PIP to transfer each reconstructed file to 
another tape (to reconstruct the file bit maps) . 
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APPENDIX F 


SUMMARY OF KEYBOARD COMMANDS 
FOR THE ADVANCED MONITOR ENVIRONMENT 


SYSTEM PROGRAM 

LOAD 

COMMANDS 

Command 


System Program Loaded 

F4 


FORTRAN IV Compiler 

F4I 


8K FORTRAN IV Compiler (DECtape I/O only) 

MACRO 


MACRO-15 Assembler 

MACRO I 


8K MACRO Assembler (DECtape I/O only) 

PIP 


Peripheral Interchange Program 

EDIT 


Symbolic Text Editor 

EDITVP 


Symbolic Text Editor using VP15A Display 

LOAD 


Linking Loader 

GLOAD 


Linking Loader (set to load and go) 

DDT 


Dynamic Debugging Technique program 

DDTNS 


DDT program with no user symbol table 

UPDATE 


Library File Update program 

DUMP 


Program to dump saved area (see CTRL Q and 
QDUMP commands) . 

PATCH 


System tape Patch program 

CHAIN 


Program which permits the creation of a 
system of core overlays. 

EXECUTE 

(E) 

Control program to load and supervise 
core residency during the execution of 
a CHAIN-built overlay system. 

SGEN 


System Generation program 

SRCCOM 


Source Compare program 

DTCOPY 


8K High-speed DECtape Copy program. 


F-1 



CONTROL CHARACTER COMMANDS 


Command 
CTRL S 

CTRL C 

CTRL T 

CTRL R 

CTRL P 


Echoes 
f S 

f C 

i T 

+ R 

j- p 


CTRL Q n i Q 


CTRL U @ 

RUBOUT 


Action 

Starts user program after loading by 
Linking Loader. 

Returns to Monitor; may be used at 
any time — resets all .DAT slot assign- 
ments . 

a. Returns control to DDT if DDT is 
being used. 

b. Skips to next job when in Batch mode. 

Allows program to continue after lOPS 4 
message. 

a. Reinitializes or restarts system 
program. 

b. Returns to location specified in 
user program's last . INIT referenc- 
ing the Teletype. 

Saves core image on save area on DECtape 
(or other system device medium, if 
available) mounted on unit n (may be 
system device) and returns to Monitor. 

Cancels current line on Teletype 
(input or output) . 

Cancels last character input from 
Teletype (not applicable with DDT) . 


BATCH PROCESSOR COMMANDS 

Command Function 


BATCH (B) dv Enter Batch mode with dv as batch device; dv 

can be typed as 

PR, for paper tape reader, or 
CD, for card reader. 

$JOB Used to separate jobs. 

$DATA Beginning of data — all inputs up to $END are 

not echoed on the Teletype. 

$END End of data. 

$EXIT Leave Batch mode. 


NOTE 

The following commands are illegal when operating in Batch 
mode: QDUMP , HALT, GET (all forms), BATCH, LOAD, DDT, and 
DDTNS . 


Special Batch Processor control characters include the following: 
CTRL T (echoes IT) Skip to next job. 

CTRL C (echoes fC) Leave Batch mode. 
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SPECIAL FUNCTION COMMANDS 


Command 

Action 

API OFF 

Disables API. 

API ON 

Enables API. 


ASSIGN (or A) 


Allows reassignment of .DAT slots to devices 
other than those set at system generation time. 
Example: A PRA -10;3/PPA -6,4 

CHANNEL (or C) 

7/9 

This command establishes whether the default 
condition for magnetic tape operation is to be 
7-channel or 9-channel. 

DIRECT (or D)n 

Lists the directory of the System Device unit 
n (0-6) . 

GET (or G)n 


Restores core image from the system device 
medium, if available, on unit n (0-7) . 

GET (or G) n 
address 


Restores core image from the system device 
medium, if available, on unit n and restarts 
at specified address. 

GET (or G)n 
HALT (or H) 


Restores core image from the system device 
medium, if available, on unit n and halts. 

HALT (or H) 


Conditions the Monitor to halt in the event 
of an unrecoverable lOPS error. 

INSTRUCT (or 

I) 

Types list of Monitor commands. 

INSTRUCT (or 
ERRORS 

I) 

Types system error messages. 

LOG (or L) 


Can be followed by any comment and terminated 
by ALT MODE. 

NEWDIR (or N) 

n 

Writes empty directory onto the system device, 
unit n (units 1-7 only) . 

QDUMP (or Q) 


Conditions Monitor to dump memory on the "save 
area" of the system tape (or other system 
device medium, if available) in the event of 
an unrecoverable lOPS error. 

REQUEST (or R) 

Types .DAT slot assignments and use: 

a. For system program when followed by system 
program name. Example: R DDT 

b. For all positive .DAT slots when followed 

by USER. Example: R USER 

c. For all .DAT slots when followed by 
carriage return. Example: R^ 

SCOM (or S) 


Causes typeout of system configuration informa- 
tion, including available device handlers. 

X4K ON 


Permits the Monitor and programs run under the 
Monitor to use an extra 4K of core (i.e., 12K, 
20K, 28K) . 

X4K OFF 


Terminates use of extra 4K page of core. 

33TTY ON 


Permits the Monitor to properly interface to a 
Model 33 Teletype unit (convert tabs to spaces) 

33TTY OFF 


Permits the Monitor to interface to a Model 35 
or 37 Teletype unit. 
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APPENDIX G 


OPTIONAL ADVANCED SOFTWARE 


page/bank mode system PROGRAMS 

The differences between the Page and Bank mode System Programs, as they 
exist in the V5A version of the ADVANCED Monitor Software System, are 
described in the following paragraphs. If no description of a System 
Program is given in the following, then the program is the same in both 
the Page and Bank mode systems. 

Keyboard Monitor 

The ADVANCED Keyboard Monitor for the Bank mode system (identified as 
KM9-15 V5A) operates exclusively in the Bank mode. This monitor has 
an EEM instruction in location 1 of the program and the needed JMP to 
the skip chain in location 2. The Keyboard monitor for the Page mode 
has the JMP instruction in location 2 since, in this mode, the PDP-15 
is always in the extended mode . 

System Loader - Bank Mode 

In a Bank mode system, the System Loader C-SYSLD) loads all programs 
(both handlers and System programs) in Bank mode. Specifically, the 
.SYSLD, DDT and EXECUTE programs operate in Bank mode as do the user 
programs which they load. 

CHAIN (V5A) and EXECUTE (V4 a) 

The CHAIN System program assumes, unless otherwise instructed, that 
the program to be built will run in Bank mode (Page mode option is 
not used) . The program EXECUTE, loads and runs overlay systems in 
Bank mode only. EXECUTE itself runs in Bank mode. Program units 8K 
or smaller may be handled. 

89TRAN 

The Bank mode system contains a relocatable binary for the translation 
of PDP-8 assembly language to PDP-9 assembly language. Users of PDP-15 
systems should delete this program since the 8 to 15 translator program 
(8TRAN) is also on the tape. 
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BANK MODE RB09 DISK SYSTEM 


In order to generate a Bank mode system which will utilize the RB09 
disk as the system device, it is necessary to make patches (PATCH) to 
the standard system and to insert (UPDATE) the RB disk handlers into 
the system library. The following procedure must be performed: 


A. Use Patch to change the 4 locations as follows: 


$A DTAj? -1 4^ 
$PATCHP 


PATCH VIA 
>B 423 
>L 3 / 

j2( 3/ 7j2f 7)21)3 1> 7)21712 1<ALTM0DE> /lOT IN THE SKIP CHAIN. 


>B 523 
>L 3 / 

)2()2f)Z()2f3/3)3112)3> 3)2fl32^< ALTMODE> 
>L 127^ 

0)2(12 7/7i2f7)2f)2(l> 7)37121< ALTMODE> 

>KM9-15^ 

>L 1)34^ 

^010A/301120> 3i3132j2f< ALTMODE> 
>EXIT J ' 


/MAKE BIT 10=1 
/IN .SCOM+4 IN 
/SGNBLK. 

/CHANGE DISK SKIP 
/lOT IN SGNBLK. 

/CHANGE BIT 10 TO 1 
/IN .SCOM+4 IN MONITOR 


B. Use the following UPDATE procedure to put the RB Disk handlers 
into the System Library. 

NOTE 

The peripheral tape should be on DECtape 
unit 1 and a clean scratch tape on unit 2 . 


$A DTA)3 -14/DTAl -1)3/DTA2 
$ UP DATE J 
UPDATE V8A 
>US^<ALTMODE> 

>R RFC.,DKC.J 
>R RFA.,DKA.3 
>R RFB.,DKB.5 
>R RFD- ,DKD.^ 

>D RPE.J 
>D RFF.^ 

>CJ 


15 ^ 


/INSERT THE RB DISK 
/HANDLERS AND 
/DELETE THE RF DISK 
/HANDLERS . 


On completion of the above, use PIP to replace the Library on the 
system tape with the one just generated. 


$PIP^ 

PIP Vi3A 

>D DT)3 .LIBR BIN^ 

>T DT0^DT2 .LIBR BIN^ 

>V DT)2f .LIBR BIN<ALTMODE> 
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C. It is now possible to do a system generation from the modified 
DECtape system to the Disk. Use SGEN. with DTAi2f assigned to 
-14 and DKD^ to -15, to create a system that will reside on 
disk unit 0 . 


NOTE 

If the special Keyboard Monitor (KMS915 is to be 
used, it should be placed on the DECtape system 
tape first (step A only of the procedure) and 
then the above procedure followed if a RB Disk 
system is desired. 


KMS15: SPECIAL ADVANCED MONITOR 


The special ADVANCED monitor, located on the V5A Peripheral tape, 
contains a Teletype handler with overprint capability for use with 
FORTRAN IV programs. Although aimed at users with 12K or greater 
systems, KMS can be used in 8K; it is 24^^ words longer than the 
standard monitor. 

Updating KMS15 Into the Standard V5A System 

The standard monitor is first replaced with KMS15 (or KMS915 for 
the Bank mode version) using PATCH. Once the monitor is on the 
tape, it is necessary to do a system generation to restore .DAT 
slot information and to tie the device handlers to monitor text string 
in the SCOM command. 


The following example illustrates the entire process for updating KMS: 


A. KM15 V5A 

$A DT0 -14/DTl (SYSTEM ON UNIT 0, PERIPHERAL 

$PATCH^ TAPE ON UNIT 1) 

PATCH V7A 
>KM15^ 

>READ KMS 15^ 

>EXIT^ 

B. KMS15 V5A 
$A DT0 -14,-15^ 

$SGEN^ 

SGEN V4A 
NEW SYSTEM? N 
MODIFY SYSTEM ON DT0 
API? (N) N 
33 TTY? (N) N 

A. ALTER I/O DEVICES OR HANDLERS ? N 

B. DISPLAY SKIP CHAIN? N 
CHANGE SKIP CHAIN ORDER? N 
7 CHANNEL MAGTAPE? (Y) Y 

LINE PRINTER LINE SIZE (80,120,132) l80] 

C. DISPLAY .DAT SLOTS? N 
ALTER .DAT SLOTS > (AS DESIRED BY THE USER) 

SGEN COMPLETE 


(KMS 9 15 ON THE BANK-MODE TAPE) 
(KMS915 ON THE BANK-MODE TAPE) 
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INDEX 


A coiimand, see ASSIGN command 
•ABS conditional pseudo-op, 1-7 
ADVANCED Monitor, 1-3 
Functions, 4-1 
ADVANCED Monitor system 
Assigning devices, 4-22 
Error detection and 
handling, 4-28 
Loading Monitor, 4-17 
Loading programs, 4-22 
Operation, 4-17 
System generation, 4-19 
System memory maps, 4-24 thru 
4-27 

ADVANCED Software System 
Description, 1-1 
Hardware requirements, 1-1, 1-3 
Alphanumeric 
Data, 2-9 
Line, 2-10 
Text, 1-7 

ALT MODE line terminator, 2-10 
API (Automatic Priority 
Interrupt) channels, 5-2 
API device handler, 1-4, 1-5, 2-1 
API ON/OFF command, 4-12 
API software level handlers, 5-1, 
5-7 

queueing, 5-8 
setup, 5-5, 5-7 
structure, 5-9 
ASQII character set, A-1 
data mode, 2-9 
text mode, 1-7 

ASCII-Hollerith correspondence 
table, B-1 

Assembler, MACRO, 1-6, 3-1 
ASSIGN (A) command, 4-14, 4-15, 
4-22, 5-26 

ASSIGN keyboard command, 2-14 
Assigning devices, 4-22 
@, see CTRL U 

Auto-index registers, 2-6, 5-7 
Automatic Priority Interrupt, 
see API 


B (BATCH) command, 4-28 thru 4-31 
BACKSPACE command, 3-2, 3-8 
BACKSPACE RECORD function, 3-2, 
3-8 

BATCH mode (tT) , 4-18 
Batch processing, 4-28 
BI (Block Identifier) , 4-37 

Block 

checksum, 4-38, 4-40 
control pair, 4-38 
format, magnetic tape, 4-38 
recording, 4-32 
.BLOCK pseudo op, 2-5 
Block Word Count (BWC) , 4-38 
Boolean manipulation, 1-6 


Bootstrap, see System bootstrap 
Braking on DECtape, 4-32 
Breakpoints, DDT, 1-6, 1-7 
Bulk storage devices, 4-1, 4-36 
BWC, see Block Word Count 


iC, see CTRL C 

C 7/9 command, see CHANNEL 7/9 
command 
CAL 

functions, 4-36 

handler, 2-1, 2-2, 2-4, 4-41, 5-1 
instruction, 5-1, 5-5, 5-10, 5-12 
CD (card reader), 4-28, 4-29, 5-58 
CD (Card Reader CR03B) summary, 5-58 
Chain and Execute programs, 1-8 
CHAIN, 5-26 
CHAIN (EXECUTE) , 5-26 

Changing registers, DDT, 1-7 
CHANNEL (C) 7/9 command, 4-17 

Checksum, 4-38, 4-40 
errors , 2-6 , 2-7 

.CLEAR command, 3-7 
Clock interrupts, 5-5 
.CLOSE command, 3-7 

Command and function code table, 2-4 
Commands 

file organization, 3-2 
keyboard, 4-9 
System Loader, 4-9, 4-10 
summary of keyboard, F-1 
Common, 1-5 
blank, 1-^5 
named, 1-5 
Constant, 2-13 
Continuous operation, 4-41 
Control character 
commands, 4-17 
scanning, 2-10 
table, 4-18 
Core 

image retrieval, 4-16 
memory map, 4-24, 4-27 
overflow, 4-19 
overlay, 1-8 

Correcting non-relocatable system 
programs, 1-8 

CR (Carriage Return) line termin- 
ator, 2-10 


CTRL 

C 

(^c) , 

4-18 

CTRL 

P 

(IP) , 

4-18 

CTRL 

Q 

(IQ) , 

4-18 

CTRL 

R 

(IR) , 

4-18 

CTRL 

S 

(IS) , 

4-18 

CTRL 

T 

(iT) , 

4-18 

CTRL 

U 

(@) , 

4-18 
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D command, see DIRECT command 
.DAT, see Device Assignment Table 
Data flow of ADVANCED 
Monitor, 2-2, 2-3 
Data 

modes, 2-7, 2-8 
recording modes, 4-34, 4-35 
recording, non-file- 
structured, 4-37 
$DATA command, 4-29 
DATA statement, 1-5 
DBR instruction, see debreak and 
restore instruction 
DDT (Dynamic Debugging 

Technique), 1-6, 4-12, 4-18 
DDTNS command, 4-12 
DDT (Dynamic Debugging 
Technique Program 1-6 
breakpoints, 1-7 
program patching, 1-7 
register examination, 1-7 
search facilities, 1-7 
Debreak and restore (DBR) 
instruction, 5-1, 5-5 
Decimal radix, 1-6 
DECtape or DECtape/Disk 
Systems, 4-20 
DECtape directory, 4-33 
DECtape 

file-oriented, 4-32 
non-file-oriented, 4-32 
storage retrieval, 4-43 
summary, 5-34 

.DEFIN conditional pseudo-op, 1-6 
Default operation bit, 4-17 
DELETE command, magnetic 
tape, 4-43 

Deletion of file, 3-6 
Device assignment, 4-22 
Device Assignment Table (.DAT), 
2-1, 2-11 

listing for standard 8K DECtape 
system, 4-21 
printout, 4-13, 4-14 
slot functions for system 
programs, 4-23 
slot reassignment, 4-14 
slots, 2-13 

variations listing for system 
of 16K or greater, 4-22 
Device handlers, 1-4, 2-13, 

5-1, 5-21 

DIRECT (D) command, 4-15 
Directory 

bit map (DECtape) 4-33 
printout, 4-15 
refreshing, 4-16 
.DLETE command, 3-3 
DO feature, 1-5 
Dollar sign ($) , 4-9 

DT (DECtape) summary, 5-34 
Dummy argument, 3-1 
dump command, 4-10 


Dump 

mode, 2-12 

mode data storage, 4-12 
Dump Program, 1-8, 5-26 
Dump Utility Program on Magnetic 
Tape (MTDUMP) , 4-43 

Dynamic Debugging Technique (DDT) 
Program, see DDT Program 


EAE registers, 5-7 
EDIT program, 5-23 
EDITVP, 5-23 
$END command, 4-29 
End-of-f ile 
logical, 2-6 
simulated, 4-34 
End-of-tape, 2-6 
.ENTER command, 3-6 
EOF (end-of-f ile) , 3-7 

EQUIVALENCE Statement, 1-6 
Errors, 2-6, 2-13 

detection and handling, 4-28 
lOPS, E-1 

Linking Loader and System 
Loader, D-1 

messages, 4-28, C-1, D-1, E-1 
printouts, C-1 
Example of use of system 
macros, 4-1 to 4-8 
EXECUTE, 5-26 
.EXIT command, 3-12 
$EXIT command, 4-28 
EXTERNAL statement, 1-6 


F4 (fortran IV) basic compiler, 1-6 

F4I (Imbedded) , 1-6 

F4S (expanded) , 1-6 

File bit map blocks, 4-34 

File 

directory, magnetic tape, 4-33 
name , 3-6 

name extension, 3-6 
names in labels, magnetic 
tape, 4-38 

organization, magnetic tape, 4-36 
-oriented DECtape, 4-32 
5/7 ASCII, 2-9 

packing scheme, 2-10 
FOCAL (Formulating On-line Cal- 
culations in Algebraic 
Language) program, 1-5 
Format 

absolute, 1-7 
magnetic tape block, 4-37 
relocatable, 1-7 
FORTRAN IV (F4) , 5-21 

compiler, 1-5 

FORTRAN Object Time System, 2-2 
.FSTAT command, 3-4 
.FULL conditional pseudo-op, 1-7 
Function code - command table, 2-4 
Functions (ADVANCED Monitor) , 4-1 
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GET (G) command, 4-16 
GLOAD command, 4-12 


HALT command, 4-12 
Handlers acceptable to system 
program I/O, see I/O handlers 
acceptable to system programs 
Handler features, summary of 
Standard I/O, see I/O handler 
features, summary of Standard 
Hard copy records, 4-10 
Hardware requirements, ADVANCED 
Software System, 1-1, 1-3 
Header label, magnetic tape, 4-39 
thru 4-41 

Header word pair, 2-2, 2-5, 2-7, 
4-34 


I command, see INSTRUCT command 
Image mode, 2-10, 4-16 
. INIT (Initialize) command, 3-2, ' 
3-3, 4-17, 5-6 

Input, 2-6 

Input/Output Programming System 
lOPS) , 1-4, 2-9. Also see lOPS 

Input/Output data mode termina- 
tors, 2-9 
table, 2-12 
INSTRUCT ERRORS, 4-7 
INSTRUCT (I) command, 4-7 
Interrupt, 2-1 

Interrupts to hardware priority 
level, 5-5 
clock, 5-5 
teleprinter, 5-5 
Teletype keyboard, 5-5 
I/O (Input/Output) 
call, 2-1 
communication, 2-1 
device handler entry, 5-1 
device handler, non-resident, 

2-5 

device handlers, 5-21 
hardware level handlers, 5-1 
I/O handler features , summary of 
standard, 5-28 

CDB (Card Reader CR03B) , 5-58 

DT (DECtape) , 5-34 

LPA (Line Printer) , 5-55 

PP (Paper Tape Punch) , 5-29 
PR (Paper Tape Reader, 5-32 
TTA (Teletype) , 5-28 

VPA (display) , 5-60 

I/O handlers acceptable to system 
programs, 5-21 
CHAIN, 5-26 
CHAIN (EXECUTE) , 5-26 

DTCOPY, 5-27 
DUMP, 5-26 
EDIT, 5-23 
EDITVP, 5-23 


8TRAN, 5-27 
FOCAL, 5-22 
FORTRAN IV, 5-21 
Library Update, 5-25 
Linking Loader and DDT, 5-24 
MACRO- 15, 5-21 

PIP, 5-24 
SRCCOM, 5-27 
System Generator, 5-25 
System Patch, 5-25 
.lODEV pseudo-op, 2-13 
lOPS (Input/Output Programming 
System) , 1-4 , 2-9 

ASCII mode, 2-9 
binary data, 2-10 
binary mode, 2-10 
error, 4-28 
errors listing, E-1 
mode data on paper tape, 2-10 


$JOB command, 4-29, 4-30 


Keyboard commands, special func- 
tion, 4-10 

Keyboard commands summary, F-1 
Keyboard Listener (.KLIST) , 2-2 

KSR35 DECtape system, 4-20 


L command, see LOG command 
Library Update Program, 1-8, 5-25 
Line buffers, 2-5 
Line terminator, 2-10 
Linking Loader, 1-7, 2-3, 4-22 
and DDT, 5-24 

and System Loader errors, D-1 
Listings 

octal, 1-6 

cross-referenced, 1-6 
symbolic, 1-6 
LOAD command, 4-10 
.LOAD n error, D-1 
Loading ADVANCED Monitor, 4-17 
Loading commands. System Program 
ALT MODE (ESC) , 4-10 

CHAIN, 4-10 
CR, 4-10 
DDT, 4-10 
DUMP, 4-10 
EDIT, 4-10 
EXECUTE (E) , 4-10 

F4, 4-10 

F4l, 4-10 
GLOAD, 4-10 
LOAD, 4-10 
MACRO, 4-10 
MACROI, 4-10 
PATCH, 4-10 
PIP, 4-10 
SGEN, 4-10 
UPDATE, 4-10 
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Loading Programs in ADVANCED Mon- 
itor environment, 4-22 
Locating a file on m.agnetic 
tape, 4-38 

LOG (L) command, 4-10 
Logical 

device numbers, 2-12 
end-of-file, 2-6 
I/O devices, 2-13 
-physical I/O device number, 
2-1, 2-4 

LPA (Line Printer summary) , 5-55 


Macros, 3-1 

Macros, ADVANCED Monitor, 3-2 
Macro statement terminators, 3-2 
MACRO Assembler, 1-6, 3-1 
MACRO-15 system program, 5-21 
Magnetic tape (MT) , 4-26, 4-29, 

5-44 

block format, 4-37 
file directory, 4-38 
file names in labels, 4-39 
file organization, 4-36 
file-structured data reading, 4-37 
function, 5-45 
header label, 4-41 
non-file-oriented, 4-37 
summary, 5-44 
transports, 4-29 
trailer label, 4-41 
Manual restart and dump procedures, 
4-43 

Maximum line buffer size, 2-5 
table, 2-8 

•MCD, see Monitor Decoder 
.MED, see Monitor Error Diagnostic 
program 

Monitor commands, 2-1, 2-2, 3-2 
Batch processor list, 4-29 
Monitor Command Decoder (.MCD), 2-2 
Monitor 

environment, 2-2 
Error Diagnostic (.MED) 
program, 4-28 
functions, 2-1 
systems, 1-1 

MT summary, see Magnetic Tape 
summary 

MTA. handler for magnetic tape, 

4-36, 4-37, 5-44 
MTC. handler for magnetic tape, 

4-36 

.MTAPE command, 3-8 
.MTAPE REWIND command, 3-8 
MTDUMP, Magnetic Tape Dump Utility 
Program, 4-43 

NEWDIR (N) command, 4-16 

Negative .DAT slot assignments, 4-22 

Nesting of macros, 1-6 


Non- file-oriented 
DECtape, 4-32 
magnetic tape, 4-37 
storage devices, 3-8 
Non-file-structured data recording, 
4-37 

Non-parity lOPS ASCII data, 2-9 
Non-resident device handler, 2-4 


Object Time System, 1-6, 2-2 
Octal 

listings, 1-6 
radix, 1-6 

Operating procedures ADVANCED 
Monitor System, 4-17 
Output, 2-6 


■tP, see CTRL P 

Paper Tape Punch (PP) summary, 5-29 
Paper Tape Reader (PR) , 4-28 
summary, 5-32 
Parity 

bit, 2-9, 2-10 
check, 2-9 
error, 2-6 
Patch program, 5-25 

PDP-15 lOPS ASCII Character set, A-1 
Peripheral Interchange Program, 

1-7, 4-22, 5-24 
Physical I/O devices, 2-8 
PI, see Program Interrupt 
PIC skip chain, see Program 
Interrupt Control skip chain 
PIP, see Peripheral Interchange 
Program 

PP, see Paper Tape Punch 
PR, see Paper Tape Reader 
Predefined macros, 3-1 
Program halt, 3-12 
Program Interrupt (PI) , 2-1 

Program Interrupt Control (PIC) 
skip chain, 5-15 
Program interrupt facility, 1-5 
Program loading order in ADVANCED 
Monitor environment, 4-22, 4-24, 
4-28 

Program patching (DDT) , 1-6 

Program translation (PDP-8 to 
MACRO-15) , 1-8 


IQ, see CTRL Q 

Queueing, 5-8 

QDUMP (iQ) command, 4-12 


IR, see CTRL R 

R command, see REQUEST command 
Radix control, 1-6 
.READ command, 3-8 
Real argument, 3-2 
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Real time devices, 1-5 
Recursion, 1-6 
Redefinition of macros, 1-6 
Re-entrant calls, 5-1 
Reentry, 5-8 

Referencing system macros, 3-2 
. RENAM command, 3-4 
.REFT, conditional pseudo-op, 1-6 
REQUEST (R) command, 4-13 
Retrieval, DECtape storage, 4-43 
Retrieval of subroutines, 1-7 
REWIND TO LOAD POINT, 3-8 
Rubout (\) , 4-10 


•fS , see CTRL S 
S command, see SCOM command 
Save area, 4-12 
SCOM (S) command, 4-11 
.SCOM printout, 4-11 
.SCOM, see System Communication 
Table 

Search facility (DDT) , 1-7 

.SEEK command, 3-5 
Sequential block recording, 4-37 
Setting up the skip chain and 

API (hardware) channel registers, 
5-5 

Setting up API software level 
channel registers, 5-7 
7-bit ASCII, 2-9 
SGEN, see System Generator 
Simulated end-of-file, 4-34 
6-bit trimmed ASCII, 1-6 
Skeleton I/O Device Handler 
Example A, 5-12 
Example B, 5-15 
Skip chain listing for standard 
8K DECtape system, 4-20 
Skip chain order, 4-21 
Source Compare Program (SRCCOM) , 
1-8, 5-27 

Source program, 3-1 
Special function keyboard com- 
mands, 4-10 

Specification statements, 1-5 
SRCCOM (Source Compare), 1-8, 5-27 
Staggered recording of blocks, 4-37 
Standard API channel/priority 
assignments table, 5-9 
Standard I/O handler features, see 
I/O handler features 
Storage retrieval on file- 

structured magnetic tape, 4-43 


Symbolic 

listings , 1-6 

text editing, 1-7 
.SYSLD n, D-1 

System bootstrap, 4-17, 4-19 
System Communication Table (.SCOM), 
2-13 

System configuration information, 
4-10 

System error message summary, C-1 
System Generator (SGEN) , 1-8, 5-25 

System Loader, 4-9, 4-22 
Commands, 4-9 

System macros, 3-2 also see 
Monitor commands 

System memory maps, 4-24, thru 4-27 
System Patch Program, 1--8, 5-25 
System programs available, 1-4 
System Program handlers, see I/O 
handlers acceptable to system 
programs 

Summary of keyboard commands, F-1 


fT, see CTRL T 
Tag, 2-5 

TC-59 Tape Control Unit (TCU) , 4-34 

Teletype keyboard interrupts, 5-5 
Text Editor Program, 1-7, 5-23 
.TIMER command, 3-11 
Trailer label, magnetic tape, 4-39 
.TRAN command, 2-4, 3-11 
Translation of programs, 1-8 
TTA (Teletype) summary, 5-28 
Turnaround 

reading, 4-34 
recording, 4-34 

Two-pass system (FORTRAN IV) , 1-5 

Two's complement checksum, 4-38 


USA FORTRAN IV, 1-5 
User-file labels, 4-39 
format, 4-40 


Validity bits, 2-6, 2-7 
Variables, 2-13 


.WAIT command, 2-5, 3-2, 3-4, 3-10 
.WAITR command, 2-5, 3-10 
Word count, 2-5, 2-6, 4-35 
.WRITE command, 2-6, 3-2, 3-9 
Writing special I/O device 
handlers, 5-10 
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HOW TO OBTAIN SOFTWARE INFORMATION 


Announcement's for new and revised software, as well as programming 
notes, software problems, and documentation corrections are published 
by Software Information Service in the following newsletters. 

Digital Software News for the PDP-8 & PDP-12 
Digital Software News for the PDP-11 
Digital Software News for the PDP-9/15 Family 

These newsletters contain information applicable to software available 
from Digital's Program Library, Articles in Digital Software News up- 
date the cumulative Software Performance Summary which is contained 
in each basic kit of system software for new computers. To assure that 
the monthly Digital Software News is sent to the appropriate software 
contact at your installation, please check with the Software Special- 
ist or Sales Engineer at your nearest Digital office. 

Questions or problems concerning DEC software should be reported to 
the Software Specialist, In cases where no Software Specialist is avail- 
able, please send a Software Performance Report form with details of 
the prob lem to; 

Software Information Service 
Digital Equipment Corporation 
146 Main Street, Bldg. 3-5 
Maynard, Massachusetts 01754 

These forms which are available without charge from the Program 
Library, sh.ould be fully filled out and accompanied by Teletype output 
as well as listings or tapes of the user program to facilitate a complete 
investigation. An answer will be sent to the individual and appropriate 
topics of general interest will be printed in the newsletter. 

New and revised software and manuals. Software Performance Report 
forms, and software price lists are available from the Program Library. 
When ordering, include the document number and a brief description of 
the program or manual requested. Revisions of programs and documents 
will be announced in the newsletters. Direct all inquiries and requests 
to : 

Program Li brary 
Digital Equipment Corporation 
146 Main Street, Bldg, 1-2 
Maynard, Massachusetts 01754 

Digital Equipment Computer Users Society (DECUS) maintains a user 
library and publishes a catalog of programs as well as the DECUSCOPE 
magazine for its members and non-members who request it. For further 
information please write to: 

D ECU S 

Digital Equipment Corporation 
146 Main Street, Bldg, 3-5 
Maynard, Massachusetts 01754 
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READER’S COMMENTS 


Digital Equipment Corporation maintains a continuous effort to improve the quality and usefulness of its 
publications. To do this effectively we need user feedback - your critical evaluation of this manual. 

Please comment on this manual’s completeness, accuracy, organization, usability, and readability. 


Did you find errors in this manual? 


How can this manual be improved? 


DEC also strives to keep its customers informed of current DEC software and publications. Thus, the following period- 
ically distributed publications are available upon request. Please check the appropriate boxes for a current issue of the 
publication(s) desired. 

Q Software Manual Update, a quarterly collection of revisions to current software manuals. 

Q User’s Bookshelf, a bibliography of current software manuals. 

O Program Library Price List, a list of currently available software programs and manuals. 

Please describe your position. 

Name Organization 

Street Department 

City State Zip or Country 
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